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

گرفتن خطا در کد

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

دو زبان، دو فعل، یک کار

جاوااسکریپت می‌گوید throw و catch (پرت کن و بگیر)، پایتون می‌گوید raise و except (بالا ببر و مگر این‌که). در مستندات با s می‌آیند: Throws an error if… و Raises ValueError if… . در گذشته هم بی‌قاعده‌اند: threw، caught؛ ولی raised با‌قاعده است.

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

try (تْرای): امتحان کردن، تلاش کردن

try در انگلیسی یعنی «امتحان کردن» و «تلاش کردن»: try again یعنی دوباره امتحان کن. در کد، کاری را که ممکن است خطا بدهد درون بلوک try می‌گذاری؛ یعنی «این را امتحان کن، اگر نشد برنامه را نبند، من فکرش را کرده‌ام». مثل وقتی که با احتیاط درِ قفل‌شده‌ای را امتحان می‌کنی و کلید یدکی هم در جیبت داری.

Please check your connection and try again.

لطفاً اتصالت را بررسی کن و دوباره امتحان کن.

catch (کَچ): گرفتن (در هوا)

catch در انگلیسی یعنی «گرفتن» چیزی که پرت شده، مثل گرفتن توپ. در جاوااسکریپت و Java خطا را throw می‌کنند (پرت می‌کنند) و بلوک catch آن را می‌گیرد تا برنامه زمین نخورد. درون catch می‌نویسی با آن خطا چه کار شود. معادلش در پایتون except است.

Use try and catch to handle network errors.

برای رسیدگی به خطاهای شبکه از try و catch استفاده کن.

except (اِکسِپت): به‌جز، مگر

except در انگلیسی یعنی «به‌جز»: every day except Friday یعنی هر روز به‌جز جمعه. در پایتون بعد از try می‌آید و می‌گوید «مگر این‌که این خطا پیش بیاید؛ آن وقت این کار را بکن». اسمِ خطا را جلویش می‌نویسی تا فقط همان نوع خطا گرفته شود.

All tests passed except the last one.

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

finally (فاینِلی): در پایان، سرانجام

finally در انگلیسی یعنی «سرانجام» و «در آخر»: finally, it works یعنی بالاخره کار کرد. در کد، بلوک finally بعد از try می‌آید و هر چه بشود اجرا می‌شود، چه خطایی پیش آمده باشد چه نه. برای کارهای جمع‌وجور کردن خوب است، مثل بستن فایل. مثل خاموش کردن چراغ هنگام رفتن: مهمانی خوب بوده یا بد، چراغ را خاموش می‌کنی.

Finally, restart the server to apply the changes.

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

throw (ثْرو): پرت کردن؛ اعلام خطا

throw در انگلیسی یعنی «پرت کردن»: throw the ball یعنی توپ را پرت کن. در جاوااسکریپت و Java با throw خودت یک خطا می‌سازی و «پرتش می‌کنی»؛ اجرای عادی همان‌جا می‌ایستد و خطا بالا می‌رود تا یک catch آن را بگیرد. وقتی به کار می‌آید که ورودی آن‌قدر غلط است که ادامه دادن معنی ندارد.

This method throws an error if the file does not exist.

اگر فایل وجود نداشته باشد، این متد خطا می‌دهد.

raise (رِیز): بالا بردن؛ اعلام خطا (در پایتون)

raise در انگلیسی یعنی «بالا بردن»: raise your hand یعنی دستت را بالا ببر. در پایتون با raise خودت یک خطا اعلام می‌کنی؛ درست مثل شاگردی که دستش را بالا می‌برد و می‌گوید «این‌جا مشکلی هست». همان کاری است که throw در جاوااسکریپت می‌کند.

The function raises a ValueError if the age is negative.

اگر سن منفی باشد، تابع یک ValueError اعلام می‌کند.

assert (اَسِرت): با اطمینان گفتن؛ بررسیِ یک فرض

assert در انگلیسی یعنی «با اطمینان گفتن» که چیزی درست است. در کد با assert می‌گویی «من مطمئنم این شرط درست است؛ اگر نبود همین‌جا خطا بده». بیشتر در تست‌ها به کار می‌رود تا بررسی کنند جوابِ یک تابع همان است که باید باشد.

The test asserts that the result is equal to 4.

تست بررسی می‌کند که نتیجه برابر ۴ باشد.

with (ویث): با، همراهِ

with در انگلیسی یعنی «با» و «همراهِ»: come with me یعنی با من بیا. در پایتون، with یعنی «با این چیز کار کن و وقتی تمام شد خودت جمعش کن». بیشتر برای فایل به کار می‌رود: فایل را باز می‌کند و آخرِ بلوک، حتی اگر خطایی پیش بیاید، خودش آن را می‌بندد.

Open the file with a text editor.

فایل را با یک ویرایشگر متن باز کن.

مستنداتِ یک تابع

load_scores(path)

Opens the file with the given path and returns a list of scores.

Raises FileNotFoundError if the file does not exist. In JavaScript, the same function throws an Error, and you can catch it.

Example:

try:
scores = load_scores("scores.txt")
except FileNotFoundError:
scores = []
finally:
print("Loading finished")

The finally block always runs, with or without an error.

load_scores(path)

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

اگر فایل وجود نداشته باشد FileNotFoundError اعلام می‌کند. در جاوااسکریپت همین تابع یک Error پرت می‌کند و می‌توانی آن را بگیری.

مثال:

try:
scores = load_scores("scores.txt")
except FileNotFoundError:
scores = []
finally:
print("Loading finished")

بلوک finally همیشه اجرا می‌شود، با خطا یا بدون خطا.