بتل کد Battle Codeدارد باز می‌شود…

جمله‌های خطا

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

فعل‌های کمکی: must، should، cannot، may not

این فعل‌ها قبل از فعل اصلی می‌آیند و می‌گویند کار چقدر لازم یا مجاز است. از محکم به نرم: must (حتماً باید)، should (بهتر است)، may (مجاز است). منفی‌هایشان: cannot (نمی‌شود)، must not و may not (مجاز نیست). بعدشان فعل ساده می‌آید، بدون to و بدون s: It must be a number، نه must to be.

هشت کلمه‌ی این درس

cannot (کَن‌نات): نمی‌تواند؛ نمی‌شود

can یعنی توانستن و cannot یعنی نتوانستن. شکل کوتاه و خودمانی‌اش can't است، ولی پیام‌های خطا رسمی‌ترند و بیشتر cannot می‌نویسند. الگویش همیشه cannot + فعل است: Cannot read، ‏cannot import، ‏cannot open، یعنی «نمی‌شود خواند»، «نمی‌شود آورد»، «نمی‌شود باز کرد». بقیه‌ی جمله می‌گوید چه چیزی را و چرا.

You cannot change a string in Python; make a new one.

در پایتون نمی‌توانی یک رشته را عوض کنی؛ یک رشته‌ی تازه بساز.

unable (آن‌اِیبِل): ناتوان؛ نتوانست

able یعنی توانا و unable یعنی ناتوان. الگویش unable to + فعل است و همان معنی cannot را می‌دهد، فقط رسمی‌تر: Unable to connect یعنی «نتوانستم وصل شوم». معمولاً از مشکلی بیرون از کد تو خبر می‌دهد: شبکه، فایل، سرور یا اجازه‌ی دسترسی.

The app was unable to save the file because the disk is full.

برنامه نتوانست فایل را ذخیره کند، چون دیسک پر است.

must (ماست): باید (حتماً)

must یعنی «باید»، از نوع محکمش: قانون است و راه دیگری نیست. وقتی خطا می‌گوید X must be Y، دارد قانونی را می‌گوید که شکسته‌ای، و همان جمله راه درست را هم نشان می‌دهد. مثلاً indices must be integers یعنی «شماره‌ی خانه‌ها باید عدد صحیح باشند». در مستندات هم must یعنی اگر نکنی، کار نمی‌کند.

The password must be at least eight characters long.

رمز عبور باید دست‌کم هشت نویسه باشد.

should (شُود): بهتر است؛ باید (توصیه)

should هم یعنی «باید»، ولی نرم‌تر از must: توصیه است، نه قانون. You should update یعنی «بهتر است به‌روز کنی»؛ اگر نکنی برنامه هنوز کار می‌کند. برای همین should را بیشتر در warning می‌بینی تا در error. معنی دومی هم دارد: «قاعدتاً»؛ This should work یعنی «قاعدتاً باید کار کند».

You should close the file after you finish reading it.

بهتر است بعد از تمام شدن خواندن، فایل را ببندی.

may not (مِی نات): اجازه نیست؛ شاید هم: ممکن است نشود

may دو معنی دارد و باید از جمله بفهمی کدام است. یکی «اجازه داشتن»: در قانون‌ها و پیام‌های خطا، may not یعنی «مجاز نیست»، مثل This field may not be blank (این خانه نباید خالی بماند). دیگری «شاید»: در توضیح‌ها، may not یعنی «شاید نشود»، مثل This may not work on old browsers (شاید در مرورگرهای قدیمی کار نکند).

The username may not contain spaces or special characters.

نام کاربری نباید فاصله یا نویسه‌ی خاص داشته باشد.

no such (نو ساچ): چنین … وجود ندارد

such یعنی «چنین» و no such یعنی «چنین چیزی نیست». بعدش همیشه اسم همان چیز می‌آید: No such file or directory یعنی «چنین فایل یا پوشه‌ای وجود ندارد»، no such table یعنی «چنین جدولی نیست». این یکی از پرتکرارترین خطاهای دنیاست و سه دلیل معمول دارد: غلط تایپی در اسم، پسوند جاافتاده، یا این‌که در پوشه‌ی دیگری هستی.

There is no such file in this folder; check the name.

چنین فایلی در این پوشه نیست؛ اسمش را بررسی کن.

already exists (آل‌رِدی اِگزیستس): از قبل وجود دارد

already یعنی «از قبل» و exist یعنی وجود داشتن. این پیام درست برعکس not found است: می‌خواهی چیز تازه‌ای بسازی (فایل، پوشه، شاخه، حساب کاربری) ولی چیزی با همین اسم از قبل هست. کامپیوتر برای این‌که قبلی را خراب نکند، دست نگه می‌دارد. یا اسم دیگری انتخاب کن، یا از همان که هست استفاده کن.

A user with this email already exists; try to log in.

کاربری با این ایمیل از قبل وجود دارد؛ وارد حسابت شو.

not allowed (نات اِلَود): مجاز نیست

allow یعنی اجازه دادن و allowed یعنی مجاز. not allowed یعنی «اجازه‌ی این کار داده نشده». خطای وبِ 405 Method Not Allowed یعنی این نشانی هست، ولی با این روش نمی‌شود سراغش رفت؛ مثلاً POST فرستاده‌ای و فقط GET قبول می‌کند. مرورگرها هم خطایی به نام NotAllowedError دارند، برای کارهایی که کاربر باید اول اجازه‌شان را بدهد.

Students are not allowed to delete other users' posts.

دانش‌آموزها اجازه ندارند نوشته‌های کاربران دیگر را پاک کنند.

دو خطای ترمینال و چند قانون

$ mkdir photos
mkdir: cannot create directory 'photos': File exists

The folder already exists, so the command cannot make it again.

$ cat notes.txt
cat: notes.txt: No such file or directory

There is no file with this name here. Check the spelling.

Rules from the docs of our API:
- The username must be unique.
- The password should be longer than 12 characters.
- The username may not contain spaces.
- Guests are not allowed to delete posts.

If the app is unable to save your data, it shows an error.

$ mkdir photos
mkdir: cannot create directory 'photos': File exists

این پوشه از قبل وجود دارد، پس دستور نمی‌تواند دوباره آن را بسازد.

$ cat notes.txt
cat: notes.txt: No such file or directory

فایلی با این اسم این‌جا نیست. املای اسم را بررسی کن.

قانون‌هایی از مستندات API ما:
- نام کاربری باید یکتا باشد.
- بهتر است رمز عبور بلندتر از ۱۲ نویسه باشد.
- نام کاربری نباید فاصله داشته باشد.
- مهمان‌ها اجازه ندارند نوشته‌ها را پاک کنند.

اگر برنامه نتواند داده‌هایت را ذخیره کند، یک خطا نشان می‌دهد.