سیستم پرونده fs
خواندن و نوشتن پرونده، اطلاعات، زمانها و مجوزها، رونوشت و جابهجایی، و چکیدهی MD5 و SHA.
واردسازی سیستم پرونده
نام آرگومانها شناسهی خود کد است و معادل فارسی ندارد؛ گونهها، کلیدواژهها و نام بستهها با معادل فارسی نوشته میشوند.
بستهی سیستم پرونده هر چیزی را که برای کار با یک پرونده لازم دارید در خود دارد: خواندن کامل یا خطبهخط، نوشتن، افزودن، جایگزینی امن، رونوشت، جابهجایی و حذف، دانستن اندازه و زمانها و مجوزها، تغییر مجوز، چکیدهی پرونده و حدس نوع MIME. یک واردسازی کافی است: واردسازی سیستم پرونده و بعد سیستم پرونده.خواندن متن(مسیر). برای پوشهها از سیستم پرونده.پوشه، برای مسیرها از سیستم پرونده.مسیر و برای خواندن تکهتکهی پروندهی بزرگ از تابعهای دستگیرهی ورودی خروجی استفاده کنید. بستهی سادهتر سیستم عامل خواندن کامل پرونده، فهرست پوشه و بررسی وجود را پوشش میدهد.
بستهی قدیمی سیستم پرونده.پرونده هنوز کار میکند اما منسوخ است: هر فراخوانی را به سیستم پرونده میفرستد. در کد تازه واردسازی سیستم پرونده و سیستم پرونده.خواندن متن بنویسید، نه واردسازی سیستم پرونده.پرونده و پرونده.خواندن متن.
نوشتنها تعداد بایتهای نوشتهشده یا -۱ را برمیگردانند. خواندنها وقتی پرونده باز نشود متن خالی میدهند، درست مثل پروندهی خالی؛ وقتی این فرق مهم است وجود دارد را بپرسید.
اشتباههای رایج:
- دودوییامن دانستن این بسته. هر خواندن و نوشتنی از یک
رشتهمیگذرد که در نخستین بایت صفر تمام میشود، پسخواندن همه،خواندن بایتها،نوشتن بایتهاو تابعهای چکیده پروندهی دودویی را کوتاه میکنند. برای تصویر، بایگانی و هر دادهی دودویی دیگرخواندن پرونده دودوییونوشتن پرونده دودوییاز بستهی بایگانی را به کار ببرید که اشارهگر و طول را جابهجا میکنند، و برای چکیده شکلهای اشارهگری بستهی رمزنگاری مثلشا۲۵۶ بایترا. - انتظار اینکه
جابجاییاز دیسکی به دیسک دیگر برود. این تابع تغییر نام است و میان دو سیستم پرونده شکست میخورد؛پوشه.جابجاییبه رونوشت برمیگردد، یا خودتان رونوشت بگیرید و حذف کنید. - گمان اینکه
نوشتن اتمیمجوزهای پروندهی قدیمی را نگه میدارد. پروندهی تازهای مینویسد که مجوزهای پیشفرض را میگیرد؛ پروندهای که به0o600تنگ کرده بودید دوباره خواندنی میشود، مگر پس از هر ذخیرهتغییر مجوزرا صدا بزنید. - به معنای «پرونده است» گرفتن
وجود دارد. برای پوشه هم درست است؛ آن را باپوشه.پوشه استهمراه کنید.
زمانها ثانیههای کامل از آغاز سال ۱۹۷۰ (زمان یونیکس) هستند، به شکل صحیح۶۴. هر تابع وقتی مسیر وجود نداشته باشد یا سیستم نتواند جواب بدهد -1 برمیگرداند.
مجوزها را به شکل هشتهشتی بنویسید، مثل 0o644 (مالک میخواند و مینویسد، بقیه فقط میخوانند). مجوزها همان رقمها را به شکل یک عدد معمولی برمیگرداند، مثل 644، تا راحت خوانده شود. این دو یک عدد نیستند (0o644 برابر ۴۲۰ است)، پس نتیجهی مجوزها را بیتغییر به تغییر مجوز ندهید.
خواندن پروندهی تنظیمات خط به خط
خواندن خطها پرونده را در شکستهای خط جدا میکند و \r انتهای خط را هم برمیدارد، پس پروندهای که در ویندوز ذخیره شده همانطور خوانده میشود که پروندهی لینوکسی. با این کار پروندههای سادهی کلید = مقدار آسان میشوند: هر خط را بپیرایید، خطهای خالی و توضیحها را رد کنید و در اولین = جدا کنید.
واردسازی سیستم پرونده
واردسازی رشته
تابع ریشه:
سیستم پرونده.نوشتن متن("برنامه.conf"، "# تنظیمات فروشگاه\nname = فروشگاه سر کوچه\n\nport = 8080\ncurrency = IRR\n")
تنظیمات := نگاشت {} برگردان نگاشت<رشته، رشته>
هر سطر در سیستم پرونده.خواندن خطها("برنامه.conf"):
ت := سطر.پیراست()
اگر ت.طول() == ۰ یا رشته.شروع با(ت، "#"): گذر پایان
جای مساوی := رشته.اندیس(ت، "=")
اگر جای مساوی < ۰: گذر پایان
تنظیمات.درج(ت.زیررشته(۰، جای مساوی).پیراست()، ت.زیررشته(جای مساوی + ۱، ت.طول() - جای مساوی - ۱).پیراست())
پایان
سرچاپ تنظیمات.اندازه()، "تنظیم"
سرچاپ "نام:"، تنظیمات.بگیر("name")
سرچاپ "درگاه:"، تنظیمات.بگیر("port")
سیستم پرونده.حذف("برنامه.conf")
پایانبرای قالبی با بخشبندی، نقلقول یا ساختار تو در تو، یک تجزیهگر واقعی مثل تامل، جیسون یا پرونده محیط را به کار ببرید.
افزودن به پروندهی گزارش
افزودن پرونده را باز میکند، متن را به انتهایش اضافه میکند و دوباره میبندد، و در اولین فراخوانی پرونده را میسازد. هر فراخوانی یک باز و بسته کردن جداست که برای یک خط گاهبهگاه خوب است. برای گزارشی پرکار، پرونده را یک بار با بازکردن(پ، "ab") باز کنید، با ورودی خروجی.نوشتن بنویسید و در پایان بستن را صدا بزنید.
واردسازی سیستم پرونده
تابع ثبت(سطر: رشته):
سیستم پرونده.افزودن("برنامه.log"، سطر.پیوست("\n"))
پایان
تابع ریشه:
ثبت("شروع شد")
ثبت("۳ سفارش بارگذاری شد")
ثبت("صورتحساب ۱۰۴۲ فرستاده شد")
ثبت("متوقف شد")
سطرها := سیستم پرونده.خواندن خطها("برنامه.log")
سرچاپ "گزارش"، سطرها.طول()، "خط و"، سیستم پرونده.اندازه("برنامه.log")، "بایت دارد"
سرچاپ "دو خط آخر:"
ناپایا ی := سطرها.طول() - ۲
تا ی < سطرها.طول():
سرچاپ " "، سطرها.بگیر(ی)
ی++
پایان
سیستم پرونده.حذف("برنامه.log")
پایانبررسی سالم رسیدن پرونده
صفحههای دانلود اغلب کنار هر پرونده چکیدهی SHA-256 آن را منتشر میکنند. چکیدهی نسخهی خودتان را با هش شا۲۵۶ حساب کنید و دو مقدار را مقایسه کنید: تغییر حتی یک بایت چکیدهی کاملاً متفاوتی میدهد. هش امدی۵ و هش شا۱ برای فهمیدن تغییرهای ناخواسته، مثلاً به عنوان کلید حافظهی پنهان، خوباند؛ اما هر کسی میتواند عمداً دو پروندهی متفاوت با MD5 یا SHA-1 یکسان بسازد، پس در برابر مهاجم به آنها اعتماد نکنید.
واردسازی سیستم پرونده
تابع سالم است(پ: رشته): منطقی:
انتظار := سیستم پرونده.خواندن متن(پ.پیوست(".sha256")).پیراست()
برگشت سیستم پرونده.هش شا۲۵۶(پ) == انتظار
پایان
تابع ریشه:
سیستم پرونده.نوشتن بایتها("انتشار.tar"، "pretend this is a release archive")
سیستم پرونده.نوشتن متن("انتشار.tar.sha256"، سیستم پرونده.هش شا۲۵۶("انتشار.tar").پیوست("\n"))
سرچاپ "سالم:"، سالم است("انتشار.tar")
سیستم پرونده.افزودن("انتشار.tar"، "!")
سرچاپ "پس از تغییر:"، سالم است("انتشار.tar")
سیستم پرونده.حذف("انتشار.tar")
سیستم پرونده.حذف("انتشار.tar.sha256")
پایانتابعهای چکیده اول پرونده را در یک رشته میخوانند و رشتهی سلام در اولین بایت صفر تمام میشود. برای پروندههای متنی این مهم نیست. اما پروندهی دودوییای که بایت صفر دارد، که بیشتر بایگانیها و تصویرها دارند، فقط تا همان بایت چکیده میشود؛ چنین پروندههایی را با sha256sum سیستم یا با تابعهای بافری رمزنگاری مثل شا۲۵۶ بایت بررسی کنید. همین محدودیت برای خواندن همه، خواندن متن، خواندن بایتها و نوشتن بایتها هم هست.
ذخیره بدون از دست دادن نسخهی قبلی
نوشتن اتمی محتوای تازه را در نام.tmp کنار پروندهی مقصد مینویسد و بعد در یک گام آن را جای مقصد میگذارد. برنامهای که در میانهی کار از کار بیفتد یا پروندهی قدیمی را باقی میگذارد یا پروندهی تازه را، هرگز نیمی از هر کدام. داده را پیش از آن روی دیسک نمینشاند، پس پس از قطع برق پروندهای که لحظهای پیش ذخیره شده روی برخی سیستمهای پرونده هنوز ممکن است از دست برود، و دو برنامه که همزمان یک پرونده را ذخیره کنند نام .tmp یکسانی دارند. رونوشت گرفتن از پروندهی قدیمی در .bak پیش از آن، یک نسخهی قبلی را هم نگه میدارد. اگر پوشه وجود نداشته باشد، نوشتن اتمی مقدار -1 برمیگرداند و پیامش را در خطا میگذارد.
واردسازی سیستم پرونده
واردسازی سیستم عامل.خطا
تابع ذخیره(پ: رشته، داده: رشته): منطقی:
اگر سیستم پرونده.وجود دارد(پ): سیستم پرونده.کپی(پ، پ.پیوست(".bak")) پایان
اگر سیستم پرونده.نوشتن اتمی(پ، داده) != ۰:
سرچاپ "ذخیره نشد:"، خطا.پیام آخرین خطا()
برگشت نادرست
پایان
برگشت درست
پایان
تابع ریشه:
ذخیره("نمایه.json"، "{\"name\": \"سارا\"}")
ذخیره("نمایه.json"، "{\"name\": \"سارا\", \"city\": \"تبریز\"}")
سرچاپ "نسخهی فعلی:"، سیستم پرونده.خواندن متن("نمایه.json")
سرچاپ "پشتیبان:"، سیستم پرونده.خواندن متن("نمایه.json.bak")
سرچاپ "پروندهی موقت ماند:"، سیستم پرونده.وجود دارد("نمایه.json.tmp")
ذخیره("پوشه-ناموجود/نمایه.json"، "{}")
سیستم پرونده.حذف("نمایه.json")
سیستم پرونده.حذف("نمایه.json.bak")
پایانفرستادن پرونده با نوع درست
سرور وب باید همراه هر پرونده یک Content-Type بفرستد. نوع مایم آن را فقط از روی پسوند و بدون توجه به کوچکی و بزرگی حروف انتخاب میکند و نوعهای رایج وب، تصویر، صدا، ویدیو و بایگانی را میشناسد؛ هر چیز دیگری application/octet-stream است که مرورگر به جای نمایش، دانلودش میکند. پسوند نقطه و شکل اصلی حروف را نگه میدارد و برای نامی که پسوند ندارد خالی است.
واردسازی سیستم پرونده
تابع ریشه:
هر نام در ["index.html"، "app.js"، "logo.SVG"، "photo.jpeg"، "داده.json"، "یادداشت"، "backup.7z"]:
پسوند := سیستم پرونده.پسوند(نام)
اگر پسوند == "": سرچاپ نام، "(بدون پسوند)"، سیستم پرونده.نوع مایم(نام)
وگرنه: سرچاپ نام، پسوند، سیستم پرونده.نوع مایم(نام)
پایان
پایان
پایانسرور HTTP معمولاً بهتر است مایم را به کار ببرد: رده مایم در آن بسته به نوعهای متنی ; charset=utf-8 اضافه میکند و قلمهای وب را هم میشناسد، و خود بسته سرآیند Content-Type و بدنههای چندبخشی را هم تجزیه میکند.
خصوصی نگه داشتن پروندهی محرمانه
پروندهی تازه مجوز پیشفرض سیستم را میگیرد، معمولاً 644، یعنی همهی حسابهای دستگاه میتوانند آن را بخوانند. برای توکن، کلید و گذرواژه، پرونده را بنویسید و بعد مجوزش را به 0o600 محدود کنید. دو شکل نوشتن را با هم اشتباه نکنید: تغییر مجوز عدد هشتهشتی میگیرد (0o600) و مجوزها همان رقمها را به شکل یک عدد معمولی برمیگرداند (600). برای همین در نمونهی زیر م % ۱۰۰ == ۰ یعنی گروه و دیگران هیچ دسترسیای ندارند.
واردسازی سیستم پرونده
تابع ریشه:
سیستم پرونده.نوشتن متن("توکن.txt"، "s3cr3t")
سیستم پرونده.تغییر مجوز("توکن.txt"، 0o644)
سرچاپ "پیش از تغییر:"، سیستم پرونده.مجوزها("توکن.txt")
سیستم پرونده.تغییر مجوز("توکن.txt"، 0o600)
م := سیستم پرونده.مجوزها("توکن.txt")
سرچاپ "پس از تغییر:"، م
اگر م % ۱۰۰ == ۰:
سرچاپ "فقط مالک میتواند آن را بخواند"
پایان
سیستم پرونده.حذف("توکن.txt")
پایانخواندن رقمهای مجوز
سه رقم به ترتیب مال مالک، گروه و بقیهاند. درون هر رقم، ۴ یعنی خواندن، ۲ یعنی نوشتن و ۱ یعنی اجرا، و خود رقم جمع اینهاست:
| رقم | حروف | معنا |
|---|---|---|
7 | rwx | خواندن، نوشتن و اجرا |
6 | rw- | خواندن و نوشتن |
5 | r-x | خواندن و اجرا |
4 | r-- | فقط خواندن |
0 | --- | هیچ |
این نمونه عدد را به همان حروفی تبدیل میکند که ls -l چاپ میکند. اسکریپت تا وقتی بیت اجرا برای مالکش روشن نباشد (0o755 یا 0o700) در پوسته اجرا نمیشود، و پوشه هم بدون این بیت باز نمیشود.
واردسازی سیستم پرونده
تابع حرفها(رقم: صحیح): رشته:
ناپایا خروجی := ""
اگر رقم >= ۴: خروجی += "r" وگرنه: خروجی += "-" پایان
اگر رقم % ۴ >= ۲: خروجی += "w" وگرنه: خروجی += "-" پایان
اگر رقم % ۲ == ۱: خروجی += "x" وگرنه: خروجی += "-" پایان
برگشت خروجی
پایان
تابع نمایش(م: صحیح): رشته:
برگشت حرفها(م / ۱۰۰) + حرفها(م / ۱۰ % ۱۰) + حرفها(م % ۱۰)
پایان
تابع ریشه:
سیستم پرونده.نوشتن متن("استقرار.sh"، "echo deploying\n")
هر حالت در [0o755 ، 0o750 ، 0o644 ، 0o600]:
سیستم پرونده.تغییر مجوز("استقرار.sh"، حالت)
م := سیستم پرونده.مجوزها("استقرار.sh")
سرچاپ م، نمایش(م)
پایان
سیستم پرونده.حذف("استقرار.sh")
پایانفقط آنچه را که عوض شده دوباره بسازید
ابزارهای ساخت مثل make با زمان تغییر تصمیم میگیرند: خروجی وقتی کهنه است که منبعش بعد از نوشته شدن خروجی تغییر کرده باشد. برای مسیری که وجود ندارد زمان تغییر مقدار -1 برمیگرداند و نمونه آن را «باید ساخت» میخواند. زمانها به ثانیهی کاملاند، پس منبع و خروجیای که در یک ثانیه نوشته شوند بهروز حساب میشوند. اینجا همین پاسخ درست است، چون خروجی بعد از منبع نوشته شده است.
واردسازی سیستم پرونده
تابع ساخت لازم است(منبع: رشته، خروجی: رشته): منطقی:
زمان ساخت := سیستم پرونده.زمان تغییر(خروجی)
اگر زمان ساخت < ۰: برگشت درست پایان
برگشت سیستم پرونده.زمان تغییر(منبع) > زمان ساخت
پایان
تابع ریشه:
سیستم پرونده.نوشتن متن("صفحه.md"، "# سلام\n")
سرچاپ "اجرای اول، ساخت لازم است:"، ساخت لازم است("صفحه.md"، "صفحه.html")
سیستم پرونده.نوشتن متن("صفحه.html"، "<h1>سلام</h1>\n")
سرچاپ "پس از ساخت، ساخت لازم است:"، ساخت لازم است("صفحه.md"، "صفحه.html")
سیستم پرونده.حذف("صفحه.html")
سرچاپ "خروجی پاک شد، ساخت لازم است:"، ساخت لازم است("صفحه.md"، "صفحه.html")
سیستم پرونده.حذف("صفحه.md")
پایاننکتههای سیستم عامل
زمان ایجادجایی که سیستم پرونده زمان ساخت را نگه نمیدارد0است، که در لینوکس رایج است. اگر مقداری میخواهید که همیشه باشد،زمان تغییررا به کار ببرید.- در لینوکس، مک و BSD تابعهای زمان و
مجوزهافرمانstatسیستم را از راه پوسته و با مسیرِ در نقلقول اجرا میکنند. برای چند پرونده سریع است، اما در حلقهای روی هزاران پرونده، اجرای این همه فرایند جمع میشود.تغییر مجوزمستقیم سیستم را صدا میزند. - ویندوز بیتهای مجوز یونیکس را ندارد و فقط یک پرچم «فقط خواندنی» دارد؛ پس
تغییر مجوزفقط همان پرچم را عوض میکند ومجوزهابرای پروندهی فقط خواندنی ۲۹۲ (0o444) و در غیر این صورت ۴۳۸ (0o666) برمیگرداند: مقدار هشتهشتی، نه رقمهایی که در یونیکس میدهد. منطق مجوزها را برای یونیکس بنویسید و همانجا آزمایش کنید.
کدام تابع برای کدام کار
| کار | تابع |
|---|---|
| خواندن یکجای پروندهی متنی کوچک | خواندن متن، یا خواندن خطها برای وکتوری از خطها |
| خواندن فقط ابتدای پرونده | خواندن بایتها |
| جایگزین کردن محتوای پرونده | نوشتن متن، یا نوشتن اتمی وقتی پرونده مهم است |
| افزودن به انتهای پرونده | افزودن |
| کار تکهبهتکه با پروندهی بزرگ | بازکردن، بعد تابعهای ورودی خروجی، بعد بستن |
| اندازه، زمانها و مجوزها با یک فراخوانی | وضعیت |
| رونوشت، جابهجایی یا حذف | کپی، جابجایی (یا تغییر نام)، حذف |
| بررسی یک دانلود | هش شا۲۵۶ |
| نوع محتوا برای پاسخ وب | نوع مایم |
گونهها
اطلاعات پرونده FileInfo
ساختار اطلاعات پرونده| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| اندازه | size | صحیح۶۴ = 0 | اندازه بر حسب بایت. |
| زمان تغییر | mod_time | صحیح۶۴ = 0 | زمان آخرین تغییر. |
| زمان دسترسی | accessed_time | صحیح۶۴ = 0 | زمان آخرین دسترسی. |
| زمان ایجاد | created_time | صحیح۶۴ = 0 | زمان ایجاد. |
| مجوزها | permissions | صحیح = 0 | مجوزها، با رقمهای هشتهشتی مثل 644. |
| وجود دارد | exists | منطقی = نادرست | اگر مسیر وجود داشته باشد (پوشه هم حساب است) درست است؛ اگر نباشد بقیهی فیلدها ۰اند. |
واردسازی سیستم پرونده
تابع ریشه:
سیستم پرونده.نوشتن متن("عکس.png"، "PNG")
و۱ := سیستم پرونده.وضعیت("عکس.png")
سرچاپ و۱.وجود دارد، و۱.اندازه، و۱.زمان تغییر > ۰، و۱.مجوزها > ۰
سرچاپ سیستم پرونده.اندازه("عکس.png")، سیستم پرونده.وجود دارد("عکس.png")
سرچاپ سیستم پرونده.زمان تغییر("عکس.png") > ۰، سیستم پرونده.زمان دسترسی("عکس.png") > ۰، سیستم پرونده.زمان ایجاد("عکس.png") >= ۰
سیستم پرونده.تغییر مجوز("عکس.png"، 0o600)
سرچاپ سیستم پرونده.مجوزها("عکس.png")
سرچاپ سیستم پرونده.پسوند("عکس.png")، سیستم پرونده.نوع مایم("عکس.png")، سیستم پرونده.نوع مایم("نامه.pdf")
سرچاپ سیستم پرونده.وضعیت("نیست.txt").وجود دارد
پایانفراداده پرونده FileMeta
ساختار فراداده پرونده| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| مسیر | path | رشته = "" | |
| وجود دارد | exists | منطقی = نادرست | |
| پرونده است | is_file | منطقی = نادرست | |
| پوشه است | is_dir | منطقی = نادرست | |
| پیوند است | is_link | منطقی = نادرست | |
| اندازه | size | صحیح۶۴ = 0 | |
| زمان تغییر | mod_time | صحیح۶۴ = 0 | |
| حالت | mode | طبیعی۳۲ = 0 | |
| خواندنی | readable | منطقی = نادرست | |
| نوشتنی | writable | منطقی = نادرست | |
| اجراپذیر | executable | منطقی = نادرست |
نوع رویداد EventKind
جداشمار نوع رویداد| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| Created | Created | | |
| Modified | Modified | | |
| Deleted | Deleted | |
رویداد Event
ساختار رویداد| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| نوع | kind | نوع رویداد | |
| مسیر | path | رشته = "" |
ناظر Watcher
ساختار ناظر| نام | انگلیسی | گونه | توضیح |
|---|---|---|---|
| ریشه | root | رشته = "" | |
| بازگشتی | recursive | منطقی = درست | |
| اثر انگشت | fingerprints | مجموعه ها.نگاشت مرتب | |
| آماده | initialized | منطقی = نادرست |
تابعها
بازکردن Open
تابع بازکردن(path: رشته، mode: رشته): پرونده*واردسازی سیستم پرونده
تابع ریشه:
سیستم پرونده.نوشتن متن("شعر.txt"، "بنی آدم اعضای یکدیگرند\n")
سیستم پرونده.افزودن("شعر.txt"، "که در آفرینش ز یک گوهرند\n")
چاپ سیستم پرونده.خواندن متن("شعر.txt")
سرچاپ سیستم پرونده.خواندن همه("شعر.txt") == سیستم پرونده.خواندن متن("شعر.txt")
خطها := سیستم پرونده.خواندن خطها("شعر.txt")
سرچاپ خطها.طول()، خطها.بگیر(۱)
سیستم پرونده.نوشتن بایتها("داده.bin"، "ABCDEF")
سرچاپ سیستم پرونده.خواندن بایتها("داده.bin"، ۳)
سیستم پرونده.نوشتن اتمی("تنظیمات.txt"، "زبان=فارسی")
سرچاپ سیستم پرونده.خواندن متن("تنظیمات.txt")
پ := سیستم پرونده.بازکردن("شعر.txt"، "rb")
سرچاپ پ.خواندن خط()
سیستم پرونده.بستن(پ)
پایانبستن Close
تابع بستن(f: پرونده*)نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
خواندن متن ReadText
تابع خواندن متن(path: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
خواندن همه ReadAll
تابع خواندن همه(path: رشته): رشتهخواندن متن. نتیجه یک رشته است، پس پروندهی دودویی در نخستین بایت صفرش بریده میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
خواندن بایتها ReadBytes
تابع خواندن بایتها(path: رشته، n: صحیح): رشتهn بایت اول پرونده را میخواند، مثلاً سرآیندی برای شناختن قالبش؛ در بایت صفر کوتاه میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
خواندن خطها ReadLines
تابع خواندن خطها(path: رشته): وکتور<رشته>\r پایانی.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
نوشتن متن WriteText
تابع نوشتن متن(path: رشته، data: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
نوشتن بایتها WriteBytes
تابع نوشتن بایتها(path: رشته، data: رشته): صحیحنوشتن متن است. داده یک رشته است، پس در نخستین بایت صفر تمام میشود و برای محتوای دودویی امن نیست.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
افزودن Append
تابع افزودن(path: رشته، data: رشته): صحیحنمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
نوشتن اتمی AtomicWrite
تابع نوشتن اتمی(path: رشته، data: رشته): صحیحpath.tmp را مینویسد و آن را روی پرونده تغییر نام میدهد، پس برنامهی قطعشده یا نسخهی کامل تازه را باقی میگذارد یا قدیمی را، هرگز پروندهی نیمهنوشته. ۰ یا -۱ (همراه با ثبت در خطا) برمیگرداند. پروندهی تازه مجوزهای پیشفرض را میگیرد و داده پیش از آن روی دیسک نشانده نمیشود.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ReadText.salam
اندازه Size
تابع اندازه(p: رشته): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
پسوند Extension
تابع پسوند(p: رشته): رشته.JPG؛ اگر نباشد خالی.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
نوع مایم MimeType
تابع نوع مایم(p: رشته): رشتهapplication/octet-stream. پرونده باز نمیشود.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
وضعیت Stat
تابع وضعیت(p: رشته): اطلاعات پروندهstat سیستم را چهار بار اجرا میکند، پس از فراخوانیهای جداگانه سریعتر نیست.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
کپی Copy
تابع کپی(src: رشته، dst: رشته): صحیحواردسازی سیستم پرونده
تابع ریشه:
سیستم پرونده.نوشتن متن("اصلی.txt"، "سلام")
سیستم پرونده.کپی("اصلی.txt"، "رونوشت.txt")
سیستم پرونده.جابجایی("رونوشت.txt"، "جابهجا.txt")
سیستم پرونده.تغییر نام("جابهجا.txt"، "نهایی.txt")
سرچاپ سیستم پرونده.وجود دارد("رونوشت.txt")، سیستم پرونده.وجود دارد("نهایی.txt")، سیستم پرونده.خواندن متن("نهایی.txt")
سیستم پرونده.حذف("نهایی.txt")
سرچاپ سیستم پرونده.وجود دارد("نهایی.txt")
پایانجابجایی Move
تابع جابجایی(src: رشته، dst: رشته): صحیحپوشه.جابجایی میتواند بهجایش رونوشت بگیرد.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Copy.salam
تغییر نام Rename
تابع تغییر نام(src: رشته، dst: رشته): صحیحجابجایی است.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Copy.salam
حذف Delete
تابع حذف(p: رشته): صحیحخطا به شکل پرونده یافت نشد ثبت میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Copy.salam
وجود دارد Exists
تابع وجود دارد(p: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
هش امدی۵ Md5Hex
تابع هش امدی۵(p: رشته): رشتهواردسازی سیستم پرونده
تابع ریشه:
سیستم پرونده.نوشتن متن("پیام.txt"، "abc")
سرچاپ سیستم پرونده.هش امدی۵("پیام.txt")
سرچاپ سیستم پرونده.هش شا۱("پیام.txt")
سرچاپ سیستم پرونده.هش شا۲۵۶("پیام.txt")
سرچاپ سیستم پرونده.هش شا۵۱۲("پیام.txt").طول()
پایانهش شا۱ Sha1Hex
تابع هش شا۱(p: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: fs-Sha256Hex.salam
هش شا۲۵۶ Sha256Hex
تابع هش شا۲۵۶(p: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: fs-Sha256Hex.salam
هش شا۵۱۲ Sha512Hex
تابع هش شا۵۱۲(p: رشته): رشتهنمونهی این مورد همراه با موارد بالاتر آمده است: fs-Sha256Hex.salam
وجود دارد Exists
تابع وجود دارد(path: رشته): منطقینمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
پرونده است IsFile
تابع پرونده است(path: رشته): منطقیپوشه است IsDir
تابع پوشه است(path: رشته): منطقیپیوند است IsLink
تابع پیوند است(path: رشته): منطقیپیوند نمادین است IsSymlink
تابع پیوند نمادین است(path: رشته): منطقیاندازه Size
تابع اندازه(path: رشته): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
قابل خواندن CanRead
تابع قابل خواندن(path: رشته): منطقیقابل نوشتن CanWrite
تابع قابل نوشتن(path: رشته): منطقیقابل اجرا CanExecute
تابع قابل اجرا(path: رشته): منطقیحالت Mode
تابع حالت(path: رشته): طبیعی۳۲تنظیم حالت SetMode
تابع تنظیم حالت(path: رشته، mode: طبیعی۳۲): منطقیخواندنی کردن MakeReadable
تابع خواندنی کردن(path: رشته): منطقینوشتنی کردن MakeWritable
تابع نوشتنی کردن(path: رشته): منطقیاجراپذیر کردن MakeExecutable
تابع اجراپذیر کردن(path: رشته): منطقیزمان تغییر ModTime
تابع زمان تغییر(path: رشته): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
تنظیم اجراپذیر SetExecutable
تابع تنظیم اجراپذیر(path: رشته، executable: منطقی = درست): منطقیدریافت Get
تابع دریافت(path: رشته): فراداده پروندهقالب حالت FormatMode
تابع قالب حالت(mode: طبیعی۳۲): رشتهخواندنی است IsReadable
تابع خواندنی است(path: رشته): منطقینوشتنی است IsWritable
تابع نوشتنی است(path: رشته): منطقیاجراپذیر است IsExecutable
تابع اجراپذیر است(path: رشته): منطقینام نوع TypeName
تابع نام نوع(path: رشته): رشتهپنهان است IsHidden
تابع پنهان است(path: رشته): منطقیزمان تغییر ModTime
تابع زمان تغییر(path: رشته): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: fs-Stat.salam
زمان دسترسی AccessedTime
تابع زمان دسترسی(path: رشته): صحیح۶۴noatime)، پس به آن تکیه نکنید.واردسازی سیستم پرونده
تابع ریشه:
سیستم پرونده.نوشتن متن("گزارش.txt"، "سلام")
ت := سیستم پرونده.زمان تغییر("گزارش.txt")
سرچاپ ت > ۰، سیستم پرونده.زمان دسترسی("گزارش.txt") > ۰، سیستم پرونده.زمان ایجاد("گزارش.txt") >= ۰
سیستم پرونده.تغییر مجوز("گزارش.txt"، 0o644)
سرچاپ سیستم پرونده.مجوزها("گزارش.txt")
پایانزمان ایجاد CreatedTime
تابع زمان ایجاد(path: رشته): صحیح۶۴نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ModTime.salam
تغییر مجوز Chmod
تابع تغییر مجوز(path: رشته، mode: صحیح): صحیح0o644. در صورت موفقیت ۰ و در صورت شکست -۱. در ویندوز فقط پرچم فقط خواندنی عوض میشود.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ModTime.salam
مجوزها Permissions
تابع مجوزها(path: رشته): صحیح644؛ اگر مسیر نباشد -۱. در ویندوز بهجایش ۲۹۲ یا ۴۳۸ برمیگرداند.نمونهی این مورد همراه با موارد بالاتر آمده است: fs-ModTime.salam
جدید New
تابع جدید(root: رشته، recursive: منطقی = درست): ناظرتصویر فوری Snapshot
تابع تصویر فوری(w &: ناظر)بررسی Poll
تابع بررسی(w &: ناظر): وکتور<رویداد>بررسی با تاخیر PollSleepMs
تابع بررسی با تاخیر(w &: ناظر، ms: صحیح): وکتور<رویداد>بازنشانی Reset
تابع بازنشانی(w &: ناظر)آزادسازی رویدادها FreeEvents
تابع آزادسازی رویدادها(events &: وکتور<رویداد>)آماده است IsInitialized
تابع آماده است(w &: ناظر): منطقیریشه Root
تابع ریشه(w &: ناظر): رشتهآزادسازی Free
تابع آزادسازی(w &: ناظر)