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

خطا `os/error`

آخرین خطای عملیات پرونده و فرآیند: کد، پیام و مسیری که مشکل داشته.

واردسازی سیستم عامل.خطا

در این صفحه

بررسی یک عملیات و توضیح شکست آن
خطا تا پاکش نکنید می‌ماند
گزارش خطا از تابع‌های خودتان
برنامه‌ای که اجرا نمی‌شود
گونه‌ها
پایاها و متغیرها
تابع‌ها

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

تابع‌های ساده‌ی بسته‌ی سیستم عامل چیزی این‌جا ثبت نمی‌کنند و فقط -۱ برمی‌گردانند. این بسته با بسته‌ی عمومی خطا فرق دارد که مقدار خطا برای برگرداندن از تابع‌های خودتان می‌سازد؛ برای کد تازه‌ای که به پرونده و فرآیند مربوط نیست، آن را ترجیح دهید.

پیش از تصمیم‌گیری بر پایه‌ی کد، بدانید بسته‌های استاندارد واقعاً چه چیزی ثبت می‌کنند:

کد	ثبت‌کننده
`خطای ورودی خروجی`	تقریباً همه‌ی شکست‌ها: `پوشه` (ساختن، حذف، رونوشت و جابه‌جایی)، `پرونده` (نوشتن اتمی، رونوشت و جابه‌جایی) و `موقت`
`پرونده یافت نشد`	فقط `پرونده.حذف`، برای هر شکستی در حذف، کمبود مجوز هم
`فرآیند ناموفق`	`فرآیند`، وقتی برنامه‌ای اجرا نمی‌شود
بقیه	هنوز هیچ بخشی از کتابخانه‌ی استاندارد؛ برای `تنظیم خطا`ی خودتان‌اند

خواندن‌ها و نوشتن‌های ساده، مثل پرونده.خواندن متن و نوشتن متن، چیزی ثبت نمی‌کنند؛ نتیجه‌شان را بررسی کنید. پیام‌ها عبارت‌های ثابت انگلیسی مثل delete failed هستند، نه دلیلی که سیستم گفته، و system_code را فقط فرآیند پر می‌کند.

بررسی یک عملیات و توضیح شکست آن

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

os-error-guide-explain.salam

واردسازی سیستم عامل.خطا
واردسازی سیستم پرونده.پرونده

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

تابع حذف پیش نویس(نام: رشته):
    خطا.پاک کردن خطا()
    پرونده.حذف(نام)
    اگر خطا.خطا دارد():
        سرچاپ "حذف نشد:"، توضیح(خطا.آخرین خطا())
        برگشت
    پایان
    سرچاپ "حذف شد:"، نام
پایان

تابع ریشه:
    پرونده.نوشتن متن("پیش‌نویس.txt"، "یادداشت")
    حذف پیش نویس("پیش‌نویس.txt")
    حذف پیش نویس("پیش‌نویس.txt")
پایان

خروجیحذف شد: پیش‌نویس.txt حذف نشد: چنین پرونده‌ای نیست: پیش‌نویس.txt

برای تصمیم‌گیری code را با ثابت‌های این بسته مقایسه کنید، نه message را: پیام برای خواندن آدم‌هاست و ممکن است از نسخه‌ای به نسخه‌ی دیگر عوض شود.

خطا تا پاکش نکنید می‌ماند

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

os-error-guide-clear.salam

واردسازی سیستم عامل.خطا
واردسازی سیستم پرونده.پرونده

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

خروجیپس از یک نوشتن موفق: true delete failed پس از پاک کردن و یک نوشتن موفق: false پس از حذف سالم.txt: false

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

گزارش خطا از تابع‌های خودتان

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

os-error-guide-own.salam

واردسازی سیستم عامل.خطا
واردسازی سیستم پرونده.پرونده

تابع خواندن درگاه(مسیر: رشته): صحیح:
    خطا.پاک کردن خطا()
    اگر وارونه پرونده.وجود دارد(مسیر):
        خطا.تنظیم خطا(خطا.پرونده یافت نشد، "پرونده‌ی تنظیمات نیست"، "خواندن درگاه"، مسیر، ۰)
        برگشت ۰
    پایان
    متن := پرونده.خواندن متن(مسیر).پیراست()
    درگاه := متن.به صحیح()
    اگر درگاه <= ۰ یا درگاه > ۶۵۵۳۵:
        خطا.تنظیم خطا(خطا.مسیر نامعتبر، "شماره‌ی درگاه نیست: " + متن، "خواندن درگاه"، مسیر، ۰)
        برگشت ۰
    پایان
    برگشت درگاه
پایان

تابع نمایش(مسیر: رشته):
    درگاه := خواندن درگاه(مسیر)
    اگر خطا.خطا دارد():
        خ := خطا.آخرین خطا()
        سرچاپ خ.عملیات + "(" + خ.مسیر + "):"، خ.پیام
        برگشت
    پایان
    سرچاپ مسیر، "می‌گوید درگاه"، درگاه
پایان

تابع ریشه:
    پرونده.نوشتن متن("درست.conf"، "8080\n")
    پرونده.نوشتن متن("خراب.conf"، "هشتاد\n")
    نمایش("درست.conf")
    نمایش("خراب.conf")
    نمایش("ناموجود.conf")
    پرونده.حذف("درست.conf")
    پرونده.حذف("خراب.conf")
پایان

خروجیدرست.conf می‌گوید درگاه 8080 خواندن درگاه(خراب.conf): شماره‌ی درگاه نیست: هشتاد خواندن درگاه(ناموجود.conf): پرونده‌ی تنظیمات نیست

برنامه‌ای که اجرا نمی‌شود

بسته‌ی فرآیند وقتی اصلاً نتواند برنامه‌ای را اجرا کند، مثلاً چون مسیرش غلط است، اینجا فرآیند ناموفق را ثبت می‌کند. این با برنامه‌ای که اجرا می‌شود و با کدی غیر صفر بیرون می‌آید فرق دارد: در آن حالت اینجا خطایی نیست و کد را از انتظار می‌خوانید.

os-error-guide-process.salam

واردسازی سیستم عامل.خطا
واردسازی سیستم عامل.فرآیند

تابع ریشه:
    ناپایا آرگ := وکتور {} برگردان وکتور<رشته>
    دیرکن آرگ.آزادکن()
    آرگ.بیفزا("--version")
    خطا.پاک کردن خطا()
    ناپایا ف := فرآیند.شروع با ضبط("/no/such/program"، آرگ)
    اگر خطا.خطا دارد():
        خ := خطا.آخرین خطا()
        سرچاپ "اجرا نشد:"، خ.کد == خطا.فرآیند ناموفق، خ.عملیات، خ.مسیر
        برگشت ۰
    پایان
    کد := فرآیند.انتظار(ف)
    فرآیند.پاکسازی(ف)
    سرچاپ "اجرا شد، ولی با این کد بیرون آمد:"، کد
پایان

خروجیاجرا نشد: true StartCaptured /no/such/program

فیلد system_code شماره‌ی خود سیستم عامل را نگه می‌دارد، اگر بسته آن را بداند: نتیجه‌ی posix_spawnp در یونیکس و GetLastError در ویندوز، آن هم فقط از فرآیند. در بقیه‌ی جاها صفر است. برای گزارش‌ها به کار می‌آید؛ تصمیم را بر پایه‌ی code بگیرید.

گونه‌ها

خطای سیستم عامل `OSError`

ساختار خطای سیستم عامل

جزئیات یک خطا.

نام	انگلیسی	گونه	توضیح
کد	`code`	`صحیح = 0`	کد خطا؛ یکی از ثابت‌های بالا.
پیام	`message`	`رشته = ""`	عبارت ثابت و کوتاه انگلیسی مثل `mkdir failed`؛ دلیلی را که سیستم گفته در خود ندارد.
عملیات	`operation`	`رشته = ""`	نام تابعی که خطا داده.
مسیر	`path`	`رشته = ""`	مسیری که مشکل داشته.
کد سیستم	`system_code`	`صحیح = 0`	شماره‌ی خطای خود سیستم عامل اگر معلوم باشد؛ فقط `فرآیند` پرش می‌کند و در بقیه‌ی جاها ۰ است.

os-error-Last.salam

واردسازی سیستم عامل.خطا
واردسازی سیستم پرونده.پرونده

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

خروجیfalse true Delete delete failed 1 delete failed true زمان تمام شد 0 2 3 4 5 6 8