کتابخانه‌ی استاندارد · سیستم و ابزار

سیستم عامل os

کار با پرونده، پوشه، فرمان‌های سیستم، آرگومان‌های برنامه و متغیرهای محیطی.

واردسازی سیستم عامل

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

بسته‌ی سیستم عامل ساده‌ترین راه برای کار با سیستم است: خواندن و نوشتن کل پرونده، پوشه‌ها، فرمان‌های پوسته، آرگومان‌های برنامه و متغیرهای محیطی. هر تابع یک کار انجام می‌دهد و مسیرها را به شکل رشته‌ی ساده می‌گیرد. جای کاربردش اسکریپت‌ها، ابزارهای ساخت و سرورهای کوچک است. وقتی باید بدانید کاری چرا شکست خورد، یا پرونده‌ای بزرگ را تکه‌تکه بخوانید، خانواده‌ی سیستم پرونده (سیستم پرونده برای پرونده‌ها، پوشه، مسیر) کار بیشتری می‌کند؛ برای ساختن مسیرها بسته‌ی مسیر پرونده و برای پیکربندی از محیط بسته‌ی محیط را ببینید.

نتیجه‌ها دو قاعده دارند. تابع‌هایی که چیزی را تغییر می‌دهند (حذف، ساخت پوشه، جابجایی، کپی، ساخت پوشه ها، حذف همه) در صورت موفقیت ۰ و در صورت شکست -۱ برمی‌گردانند و دلیلی همراهش نیست. نوشتن پرونده و افزودن به پرونده تعداد بایت‌های نوشته‌شده یا -۱ را برمی‌گردانند. تابع‌های خواندنی هنگام شکست مقدار تهی می‌دهند: خواندن پرونده متن خالی و فهرست پوشه برای پوشه‌ی ناموجود وکتور خالی.

برای کارهای تخصصی‌تر زیربسته‌هایی هم هست: فرآیند برای اجرای برنامه‌های دیگر با آرگومان‌های دقیق، پوسته برای گرفتن خروجی و خطای فرمان‌ها، سکو برای شناختن سیستم، موقت برای پرونده‌های موقت، کاربر برای کاربر جاری و خطا برای کدهای خطا.

اشتباه‌های رایج:

  • ساختن فرمان پوسته از ورودی کاربر. اجرا، اجرا با خروجی و خروجی فرمان کل رشته را به /bin/sh می‌دهند، پس نامی مثل x; rm -rf ~ فرمان دوم را هم اجرا می‌کند.
  • انتظار این‌که اجرا با خروجی خطاها را هم بگیرد. فقط خروجی استاندارد را می‌گیرد و خطای استاندارد فرمان همچنان در پایانه چاپ می‌شود. اگر هر دو را می‌خواهید، 2>&1 را به فرمان بیفزایید.
  • اجرای پیمایش روی درختی با پیوند نمادین. این تابع پیوندی را که به پوشه اشاره می‌کند مثل پوشه‌ی واقعی دنبال می‌کند، پس آن‌چه را پشت پیوند است فهرست می‌کند و روی پیوند حلقوی هرگز تمام نمی‌شود. حذف همه پیوند را دنبال نمی‌کند: خود پیوند را پاک می‌کند و به مقصدش دست نمی‌زند.
  • به کار بردن جابجایی میان دو دیسک. این تابع تغییر نام است و تغییر نام میان دو سیستم پرونده با -۱ شکست می‌خورد؛ به‌جایش رونوشت بگیرید و بعد حذف کنید.

بخش‌های زیر کارهایی را نشان می‌دهند که بیشتر با این بسته انجام می‌شوند. هر بخش یک برنامه‌ی کامل دارد و خروجی‌ای که چاپ کرده. برنامه‌ها در پوشه‌ی جاری کار می‌کنند و هر چه ساخته‌اند را در پایان پاک می‌کنند.

خواندن پرونده‌ی تنظیمات با مقدار پیش‌فرض

برنامه‌های کوچک معمولاً تنظیماتشان را در یک پرونده‌ی متنی کنار خودشان نگه می‌دارند. وجود دارد می‌گوید پرونده هنوز ساخته شده یا نه، نوشتن پرونده بار نخست آن را با مقدارهای معقول می‌سازد و خواندن پرونده همه‌ی متن را برمی‌گرداند تا تکه‌تکه‌اش کنید. هر تنظیمی که در پرونده نباشد مقدار پیش‌فرضش را می‌گیرد، پس اگر بعدها گزینه‌ی تازه‌ای بیفزایید، پرونده‌های قدیمی همچنان کار می‌کنند.

os-guide-config.salam
واردسازی سیستم عامل

تابع تنظیم(متن: رشته، کلید: رشته، پیش فرض: رشته): رشته:
    هر سطر در متن.بشکاف("\n"):
        اگر سطر.شروع با(کلید + "="):
            برگشت سطر.زیررشته(کلید.طول() + ۱، سطر.طول() - کلید.طول() - ۱)
        پایان
    پایان
    برگشت پیش فرض
پایان

تابع ریشه:
    مسیر := "برنامه.conf"
    اگر وارونه سیستم عامل.وجود دارد(مسیر):
        سیستم عامل.نوشتن پرونده(مسیر، "درگاه=8080\nنام=یادداشت‌ها\n")
        سرچاپ "پرونده‌ی پیش‌فرض نوشته شد:"، مسیر
    پایان
    متن := سیستم عامل.خواندن پرونده(مسیر)
    سرچاپ "درگاه:"، تنظیم(متن، "درگاه"، "80")
    سرچاپ "نام:"، تنظیم(متن، "نام"، "برنامه")
    سرچاپ "اشکال‌زدایی:"، تنظیم(متن، "اشکال‌زدایی"، "خاموش")
    سیستم عامل.حذف(مسیر)
پایان
خروجیپرونده‌ی پیش‌فرض نوشته شد: برنامه.conf درگاه: 8080 نام: یادداشت‌ها اشکال‌زدایی: خاموش

خواندن پرونده هم برای پرونده‌ی خالی و هم برای پرونده‌ای که نمی‌تواند بخواند رشته‌ی تهی برمی‌گرداند. اگر این فرق برایتان مهم است، مثل این برنامه اول وجود دارد را بپرسید. برای قالب‌های واقعی، به‌جای شکستن دستی سطرها، متن را با بسته‌ی JSON یا بسته‌ای مانند آن بخوانید.

نگه داشتن گزارش و چرخاندن آن

افزودن به پرونده متن را به انتهای پرونده می‌افزاید و اگر پرونده نباشد آن را می‌سازد؛ برای یک گزارش (log) همین کافی است. اندازه پرونده می‌گوید گزارش چقدر بزرگ شده. وقتی از حدی گذشت، جابجایی نامش را عوض می‌کند و افزودن به پروندهی بعدی از نو شروع می‌کند.

os-guide-log.salam
واردسازی سیستم عامل

تابع ثبت(مسیر: رشته، پیام: رشته):
    سیستم عامل.افزودن به پرونده(مسیر، پیام + "\n")
پایان

تابع ریشه:
    مسیر := "برنامه.log"
    ثبت(مسیر، "شروع شد")
    ثبت(مسیر، "سارا وارد شد")
    ثبت(مسیر، "متوقف شد")
    سرچاپ "اندازه:"، سیستم عامل.اندازه پرونده(مسیر)، "بایت"
    سطرها := سیستم عامل.خواندن پرونده(مسیر).بشکاف("\n")
    سرچاپ "نخستین رخداد:"، سطرها.بگیر(۰)
    اگر سیستم عامل.اندازه پرونده(مسیر) > ۳۲:
        سیستم عامل.جابجایی(مسیر، "برنامه.log.1")
        سرچاپ "چرخانده شد:"، سیستم عامل.وجود دارد("برنامه.log.1")، سیستم عامل.وجود دارد(مسیر)
    پایان
    ثبت(مسیر، "گزارش تازه")
    سرچاپ "اندازه‌ی تازه:"، سیستم عامل.اندازه پرونده(مسیر)
    سیستم عامل.حذف(مسیر)
    سیستم عامل.حذف("برنامه.log.1")
پایان
خروجیاندازه: 53 بایت نخستین رخداد: شروع شد چرخانده شد: true false اندازه‌ی تازه: 20

هر فراخوانی پرونده را باز می‌کند و می‌بندد، که برای چند سطر در ثانیه مشکلی نیست. برای گزارشی پرکار، پرونده را یک بار با بازکردن(مسیر، "ab") باز کنید و در همان دستگیره بنویسید.

ساختن، پیمودن و پاک کردن درخت پوشه‌ها

ساخت پوشه ها یک مسیر را با همه‌ی پوشه‌های والدی که لازم دارد می‌سازد، پس ترتیب ساختن پوشه‌ها مهم نیست. پیمایش همه‌ی پرونده‌های زیر یک پوشه را در هر عمقی فهرست می‌کند و فهرست پوشه ها فقط پوشه‌هایی را که مستقیم درون آن‌اند. در پایان حذف همه کل درخت را پاک می‌کند.

os-guide-tree.salam
واردسازی سیستم عامل
واردسازی مرتب سازی

تابع ریشه:
    سیستم عامل.ساخت پوشه ها("سایت/صفحه‌ها/وبلاگ")
    سیستم عامل.ساخت پوشه ها("سایت/دارایی‌ها")
    سیستم عامل.نوشتن پرونده("سایت/صفحه‌ها/خانه.salam"، "تابع ریشه: پایان")
    سیستم عامل.نوشتن پرونده("سایت/صفحه‌ها/وبلاگ/نخستین.salam"، "تابع ریشه: پایان")
    سیستم عامل.نوشتن پرونده("سایت/دارایی‌ها/نشان.svg"، "<svg/>")
    ناپایا شمار := ۰
    ناپایا بایت‌ها := ۰ برگردان صحیح۶۴
    هر پ در سیستم عامل.پیمایش("سایت"):
        اگر پ.ختم با(".salam"):
            شمار++
            بایت‌ها += سیستم عامل.اندازه پرونده(پ)
        پایان
    پایان
    سرچاپ "پرونده‌های کد:"، شمار، "با"، بایت‌ها، "بایت"
    پوشه‌ها := سیستم عامل.فهرست پوشه ها("سایت")
    مرتب سازی.مرتب(پوشه‌ها)
    هر نام در پوشه‌ها:
        سرچاپ "پوشه:"، نام
    پایان
    سیستم عامل.حذف همه("سایت")
    سرچاپ "پاک شد:"، وارونه سیستم عامل.وجود دارد("سایت")
پایان
خروجیپرونده‌های کد: 2 با 58 بایت پوشه: دارایی‌ها پوشه: صفحه‌ها پاک شد: true

پیمایش مسیرهای کاملی برمی‌گرداند که با پوشه‌ی داده‌شده شروع می‌شوند، ولی فهرست پوشه و فهرست پوشه ها فقط نام‌ها را می‌دهند، نام‌های پنهان هم، بدون . و ... سیستم عامل نام‌های درون پوشه را به ترتیب خاصی برنمی‌گرداند و این ترتیب از یک سیستم پرونده به دیگری فرق می‌کند. پیش از چاپ یا مقایسه، نام‌ها را مرتب کنید، همان‌طور که این برنامه با بسته‌ی مرتب سازی می‌کند.

اجرای فرمان پوسته و بررسی نتیجه

اجرا، اجرا با خروجی و خروجی فرمان فرمان را به پوسته‌ی سیستم می‌دهند، پس لوله، هدایت خروجی و نقل‌قول درست مثل پایانه کار می‌کنند. اجرا فقط کد خروج را برمی‌گرداند و فرمان مستقیم در خروجی خود برنامه چاپ می‌کند؛ برای پرسیدن «این ابزار نصب است؟» همین کافی است. اجرا با خروجی کد و خروجی استاندارد را با هم می‌دهد و خروجی فرمان فقط متن را، همراه با خط تازه‌ی پایانی، پس آن را پیراست کنید.

os-guide-commands.salam
واردسازی سیستم عامل

تابع ابزار هست(نام: رشته): منطقی:
    برگشت سیستم عامل.اجرا("command -v " + نام + " > /dev/null") == ۰
پایان

تابع ریشه:
    سرچاپ "sh هست:"، ابزار هست("sh")
    سرچاپ "ابزار ساختگی هست:"، ابزار هست("no-such-tool-here")
    ن := سیستم عامل.اجرا با خروجی("printf '۳\\n۱\\n۲\\n' | sort")
    اگر ن.کد != ۰:
        نادرست‌سرچاپ "sort شکست خورد با کد"، ن.کد
        برگشت ۱
    پایان
    چاپ ن.خروجی
    شمار := سیستم عامل.خروجی فرمان("printf 'الف\\nب\\n' | wc -l").پیراست()
    سرچاپ "سطرهایی که wc شمرد:"، شمار
پایان
خروجیsh هست: true ابزار ساختگی هست: false ۱ ۲ ۳ سطرهایی که wc شمرد: 2

چون پوسته فرمان را می‌خواند، هرگز فرمان را از متنی که کاربر نوشته نسازید: نامی مثل x; rm -rf ~ فرمان دوم را هم اجرا می‌کند. برای مقدارهای نامطمئن از بسته‌ی فرآیند استفاده کنید که هر آرگومان را دست‌نخورده به برنامه می‌دهد.

کدام تابع برای کدام کار

کارتابع
خواندن یا بازنویسی کامل یک پرونده‌ی کوچکخواندن پرونده، نوشتن پرونده
افزودن سطر به گزارشافزودن به پرونده
خواندن تکه‌تکه‌ی یک پرونده‌ی بزرگبازکردن، سپس خواندن خط و ببند روی دستگیره
دانستن این‌که مسیری هست و چیستوجود دارد، پوشه است، یا وضعیت پرونده برای همه با هم
ساختن یا پاک کردن پوشهساخت پوشه ها، حذف همه (برای یک سطح ساخت پوشه و حذف پوشه)
پیدا کردن پرونده‌های زیر یک پوشهپیمایش؛ برای یک سطح فهرست پوشه
اجرای فرمان پوستهاجرا، اجرا با خروجی، خروجی فرمان
اجرای برنامه با آرگومان‌های دقیقفرآیند یا پوسته
فهمیدن علت شکست یک عملیات پروندهسیستم پرونده همراه با خطا

گونه‌ها

اطلاعات پرونده FileInfo

ساختار اطلاعات پرونده
اطلاعاتی که وضعیت پرونده برمی‌گرداند.
نامانگلیسیگونهتوضیح
اندازهsizeصحیح۶۴ = 0اندازه‌ی پرونده بر حسب بایت.
پوشه استis_dirمنطقی = نادرستاگر مسیر یک پوشه باشد، درست است.
هستexistsمنطقی = نادرستاگر مسیر وجود داشته باشد، درست است.
os-Files.salam
واردسازی سیستم عامل

تابع ریشه:
    سیستم عامل.نوشتن پرونده("یادداشت.txt"، "سطر نخست\n")
    سیستم عامل.افزودن به پرونده("یادداشت.txt"، "سطر دوم\n")
    چاپ سیستم عامل.خواندن پرونده("یادداشت.txt")
    سرچاپ سیستم عامل.وجود دارد("یادداشت.txt")، سیستم عامل.اندازه پرونده("یادداشت.txt")
    و۱ := سیستم عامل.وضعیت پرونده("یادداشت.txt")
    سرچاپ و۱.هست، و۱.پوشه است، و۱.اندازه
    سیستم عامل.کپی("یادداشت.txt"، "رونوشت.txt")
    سیستم عامل.جابجایی("رونوشت.txt"، "نام تازه.txt")
    سرچاپ سیستم عامل.وجود دارد("رونوشت.txt")، سیستم عامل.وجود دارد("نام تازه.txt")
    سیستم عامل.حذف("نام تازه.txt")
    سرچاپ سیستم عامل.وجود دارد("نام تازه.txt")
    پ := سیستم عامل.بازکردن("یادداشت.txt"، "rb")
    سرچاپ پ.خواندن خط()
    پ.ببند()
پایان
خروجیسطر نخست سطر دوم true 30 true false 30 false true false سطر نخست

نتیجه فرمان CmdResult

ساختار نتیجه فرمان
نتیجه‌ی اجرای یک فرمان با اجرا با خروجی.
نامانگلیسیگونهتوضیح
کدcodeصحیح = 0کد خروج فرمان؛ صفر یعنی موفق.
خروجیoutرشته = ""خروجی فرمان.
os-Run.salam
واردسازی سیستم عامل

تابع ریشه:
    کد := سیستم عامل.اجرا("echo از پوسته")
    سرچاپ "کد خروج:", کد
    ن := سیستم عامل.اجرا با خروجی("echo سلام")
    سرچاپ ن.کد، "[" + ن.خروجی + "]"
    سرچاپ "[" + سیستم عامل.خروجی فرمان("echo دنیا") + "]"
    سرچاپ سیستم عامل.شناسه فرآیند() > ۰
پایان
خروجیاز پوسته کد خروج: 0 0 [سلام ] [دنیا ] true

تابع‌ها

اجرا Run

تابع اجرا(cmd: رشته): صحیح
فرمان را در پوسته‌ی سیستم (/bin/sh، یا cmd در ویندوز) اجرا می‌کند و کد خروجش را برمی‌گرداند؛ خروجی فرمان مستقیم در خروجی برنامه چاپ می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Run.salam

اجرا با خروجی RunCapture

تابع اجرا با خروجی(cmd: رشته): نتیجه فرمان
فرمان را اجرا می‌کند و کد خروج و خروجی استانداردش را با هم در یک نتیجه فرمان برمی‌گرداند. خطای استاندارد گرفته نمی‌شود؛ برای آن 2>&1 را بیفزایید. اگر پوسته راه نیفتد، code برابر -۱ است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Run.salam

خروجی فرمان Output

تابع خروجی فرمان(cmd: رشته): رشته
فرمان را اجرا می‌کند و فقط متن خروجی استانداردش را برمی‌گرداند، با خط تازه‌ی آخرش. کد خروج از دست می‌رود، پس وقتی شکست مهم است اجرا با خروجی را به کار ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Run.salam

شناسه فرآیند Pid

تابع شناسه فرآیند(): صحیح
شناسه‌ی فرآیند برنامه‌ی فعلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Run.salam

بازکردن Open

تابع بازکردن(path: رشته، mode: رشته): پرونده*
پرونده را با حالت داده‌شده باز می‌کند: "rb" برای خواندن، "wb" برای نوشتن از نو و "ab" برای افزودن. اگر نشود، پوچ برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

خروج Exit

تابع خروج(code: صحیح)
برنامه را با کد داده‌شده فوراً تمام می‌کند. در ریشه به‌جایش برگشت بنویسید، چون خروج، تابع‌های دیرکن را اجرا نمی‌کند (خطای E109).
os-Args.salam
واردسازی سیستم عامل

تابع خروج با خطا(پیام: رشته):
    نادرست‌سرچاپ پیام
    سیستم عامل.خروج(۲)
پایان

تابع خرابی جدی():
    سیستم عامل.توقف ناگهانی()
پایان

تابع ریشه:
    آرگ‌ها := سیستم عامل.آرگومان ها()
    سرچاپ "تعداد آرگومان‌ها:", آرگ‌ها.طول()
    خانه := سیستم عامل.متغیر محیطی("HOME")
    سرچاپ خانه.طول() > ۰ یا سیستم عامل.متغیر محیطی("USERPROFILE").طول() > ۰
    اگر آرگ‌ها.طول() > ۱۰:
        خروج با خطا("آرگومان‌ها بیش از اندازه‌اند")
    پایان
    اگر آرگ‌ها.طول() > ۱۰۰:
        خرابی جدی()
    پایان
پایان
خروجیتعداد آرگومان‌ها: 1 true

توقف ناگهانی Abort

تابع توقف ناگهانی()
برنامه را ناگهانی و با خطا متوقف می‌کند؛ برای وضعیتی که هیچ راه ادامه‌ای نمانده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Args.salam

آرگومان ها Args

تابع آرگومان ها(): وکتور<رشته>
آرگومان‌های خط فرمان برنامه؛ عضو صفر، نام خود برنامه است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Args.salam

متغیر محیطی Env

تابع متغیر محیطی(name: رشته): رشته
مقدار یک متغیر محیطی، یا رشته‌ی تهی اگر تعریف نشده باشد (پس متغیر خالی و ناموجود یکسان دیده می‌شوند). بسته‌ی محیط امکانات بیشتری دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Args.salam

حذف Remove

تابع حذف(path: رشته): صحیح
یک پرونده را حذف می‌کند؛ در صورت موفقیت ۰ و در صورت شکست -۱. برای پوشه حذف پوشه یا حذف همه را به کار ببرید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

ساخت پوشه Mkdir

تابع ساخت پوشه(path: رشته): صحیح
یک پوشه می‌سازد؛ پوشه‌ی والد باید از قبل باشد، و پوشه‌ای که از قبل هست شکست (-۱) حساب می‌شود.
os-Dirs.salam
واردسازی سیستم عامل

تابع ریشه:
    سیستم عامل.ساخت پوشه("پروژه")
    سیستم عامل.ساخت پوشه ها("پروژه/کد/کمکی")
    سیستم عامل.نوشتن پرونده("پروژه/خوانا.txt"، "سلام")
    سیستم عامل.نوشتن پرونده("پروژه/کد/اصلی.salam"، "تابع ریشه: پایان")
    سرچاپ سیستم عامل.پوشه است("پروژه")، سیستم عامل.پوشه است("پروژه/خوانا.txt")
    سرچاپ سیستم عامل.فهرست پوشه("پروژه/کد").طول()، سیستم عامل.فهرست پوشه ها("پروژه")
    سرچاپ سیستم عامل.پیمایش("پروژه").طول()
    سیستم عامل.کپی درخت("پروژه"، "پشتیبان")
    سرچاپ سیستم عامل.وجود دارد("پشتیبان/کد/اصلی.salam")
    اصلی := سیستم عامل.پوشه جاری()
    سیستم عامل.تغییر پوشه("پروژه")
    سرچاپ سیستم عامل.وجود دارد("خوانا.txt")
    سیستم عامل.تغییر پوشه(اصلی)
    سیستم عامل.حذف پوشه("پروژه/کد/کمکی")
    سیستم عامل.حذف همه("پروژه")
    سیستم عامل.حذف همه("پشتیبان")
    سرچاپ سیستم عامل.وجود دارد("پروژه")، سیستم عامل.پوشه موقت().طول() > ۰
پایان
خروجیtrue false 2 ["کد"] 2 true true false true

حذف پوشه Rmdir

تابع حذف پوشه(path: رشته): صحیح
یک پوشه‌ی خالی را حذف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

کپی Copy

تابع کپی(src: رشته، dst: رشته): صحیح
بایت‌های پرونده را رونوشت می‌کند و مقصد را جایگزین می‌کند. مجوزها، مثل بیت اجرایی، رونوشت نمی‌شوند. در صورت موفقیت ۰ و در صورت شکست -۱.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

جابجایی Move

تابع جابجایی(src: رشته، dst: رشته): صحیح
پرونده یا پوشه را جابه‌جا یا تغییر نام می‌دهد. چون تغییر نام است، میان دو سیستم پرونده شکست (-۱) می‌خورد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

فهرست پوشه ListDir

تابع فهرست پوشه(path: رشته): وکتور<رشته>
نام همه‌ی مدخل‌های درون یک پوشه، پنهان‌ها هم، بدون . و .. و بدون ورود به زیرپوشه‌ها. پوشه‌ی ناموجود وکتور خالی می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

پوشه است IsDir

تابع پوشه است(path: رشته): منطقی
اگر مسیر پوشه‌ای باشد که برنامه می‌تواند باز کند، یا پیوند نمادینی به چنین پوشه‌ای، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

پیمایش Walk

تابع پیمایش(root: رشته): وکتور<رشته>
مسیر همه‌ی پرونده‌های درون پوشه و زیرپوشه‌هایش را برمی‌گرداند که هر کدام با root شروع می‌شود؛ خود پوشه‌ها در فهرست نیستند. پیوندهای نمادین به پوشه را دنبال می‌کند، پس روی پیوند حلقوی تمام نمی‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

وجود دارد Exists

تابع وجود دارد(path: رشته): منطقی
اگر مسیر، پرونده یا پوشه، وجود داشته باشد درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

پوشه جاری Cwd

تابع پوشه جاری(): رشته
پوشه‌ی جاری برنامه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

مسیر واقعی RealPath

تابع مسیر واقعی(path: رشته): رشته
مسیر کامل با حل شدن همه‌ی پیوندهای نمادین، یا متن خالی اگر مسیر وجود نداشته باشد. برای بررسی این‌که پرونده‌ای داخل یک پوشه می‌ماند، همین مسیرها را مقایسه کنید، نه مسیرهایی که به شما داده‌اند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

تغییر پوشه Chdir

تابع تغییر پوشه(path: رشته): صحیح
پوشه‌ی جاری را عوض می‌کند؛ مسیرهای نسبی بعدی از آنجا حساب می‌شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

پوشه موقت TempDir

تابع پوشه موقت(): رشته
پوشه‌ی موقت سیستم: TEMP، TMP یا TMPDIR از محیط، به همین ترتیب، وگرنه /tmp.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

خواندن پرونده ReadFile

تابع خواندن پرونده(path: رشته): رشته
کل محتوای پرونده را می‌خواند؛ اگر نشود، رشته‌ی تهی. متن در نخستین بایت صفر تمام می‌شود، پس برای متن است نه پرونده‌ی دودویی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

نوشتن پرونده WriteFile

تابع نوشتن پرونده(path: رشته، data: رشته): صحیح
پرونده را با data می‌سازد یا جایگزین می‌کند و تعداد بایت‌های نوشته‌شده را برمی‌گرداند، یا -۱ اگر پرونده باز نشود (مثلاً وقتی پوشه‌اش وجود ندارد).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

افزودن به پرونده AppendFile

تابع افزودن به پرونده(path: رشته، data: رشته): صحیح
به انتهای پرونده اضافه می‌کند و اگر نباشد آن را می‌سازد؛ تعداد بایت‌های نوشته‌شده یا -۱ را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

اندازه پرونده FileSize

تابع اندازه پرونده(path: رشته): صحیح۶۴
اندازه‌ی پرونده بر حسب بایت، یا منفی یک اگر نباشد یا پوشه باشد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

وضعیت پرونده Stat

تابع وضعیت پرونده(path: رشته): اطلاعات پرونده
اطلاعات یک مسیر را یک‌جا برمی‌گرداند؛ اگر نباشد، exists نادرست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Files.salam

ساخت پوشه ها MkdirAll

تابع ساخت پوشه ها(path: رشته): صحیح
پوشه را همراه با همه‌ی پوشه‌های والد لازم می‌سازد؛ اگر از قبل باشد، کاری نمی‌کند. مسیر را با / جدا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

حذف همه RemoveAll

تابع حذف همه(path: رشته): صحیح
پرونده یا پوشه را با همه‌ی محتوایش حذف می‌کند؛ مسیر ناموجود موفقیت حساب می‌شود. مراقب باشید: برگشت‌پذیر نیست. پیوند نمادین فقط به‌عنوان پیوند حذف می‌شود و هرگز دنبال نمی‌شود، پس مقصدش سر جایش می‌ماند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

کپی درخت CopyTree

تابع کپی درخت(src: رشته، dst: رشته): صحیح
یک پوشه را با همه‌ی زیرپوشه‌ها و پرونده‌هایش رونوشت می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam

فهرست پوشه ها ListDirs

تابع فهرست پوشه ها(path: رشته): وکتور<رشته>
فقط نام زیرپوشه‌های یک پوشه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: os-Dirs.salam