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

ورودی تابع و محدوده

تابع چه می‌گیرد، چه پس می‌دهد و متغیرهایش کجا دیده می‌شوند؟ این کلمه‌ها در خطاهای «missing argument» و «is not defined» پیدا می‌شوند، و فرق argument با parameter سؤال همیشگی مصاحبه‌هاست.

صفت قبل از اسم می‌آید

در فارسی می‌گوییم «متغیر محلی» و «حلقه‌ی تودرتو»: اول اسم، بعد صفت. انگلیسی برعکس است: «a local variable»، «a nested loop»، «the global scope». پس وقتی یک گروه کلمه می‌بینی، از آخر به اول ترجمه کن: «a required positional argument» یعنی «یک آرگومانِ جایگاهیِ لازم».

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

argument (آرگیومِنت): آرگومان؛ مقداری که به تابع می‌دهی

argument مقدار واقعی‌ای است که هنگام صدا زدن تابع داخل پرانتز می‌گذاری. اگر تابع یک دستگاه آب‌میوه‌گیری باشد، argument همان سیبی است که این بار داخلش می‌اندازی. در مستندات و خطاها کوتاهش می‌کنند: arg و args.

The function takes two arguments: a name and an age.

تابع دو آرگومان می‌گیرد: یک اسم و یک سن.

parameter (پِرَمیتِر): پارامتر؛ اسم ورودی در تعریف تابع

parameter اسمی است که هنگام تعریف تابع داخل پرانتز می‌نویسی تا بگویی «این تابع چنین ورودی‌ای می‌خواهد». مثل جای خالی در یک فرم: «نام: ......». وقتی تابع را صدا می‌زنی، مقدار واقعی (argument) در این جای خالی می‌نشیند. کوتاهش param است.

The second parameter is optional and defaults to 10.

پارامتر دوم اختیاری است و پیش‌فرضش ۱۰ است.

result (ریزالت): نتیجه؛ حاصل

result یعنی «نتیجه»، همان چیزی که آخر یک کار به دست می‌آید. در برنامه‌نویسی به جواب یک محاسبه، خروجی یک تابع یا چیزهایی که یک جست‌وجو پیدا کرده می‌گویند. برای همین خیلی از برنامه‌نویس‌ها اسم متغیر جواب را result می‌گذارند.

Save the result in a variable and print it.

نتیجه را در یک متغیر نگه دار و چاپش کن.

scope (اِسکوپ): محدوده؛ جایی که یک اسم شناخته می‌شود

scope یعنی «دامنه، محدوده‌ی دید». در برنامه به بخشی از کد می‌گویند که یک متغیر در آن شناخته می‌شود. متغیری که داخل یک تابع ساخته شده فقط همان‌جا دیده می‌شود؛ مثل اسم خودمانی‌ای که فقط در خانه‌ی شما معنی دارد و بیرون کسی آن را نمی‌شناسد.

This variable is not defined in the current scope.

این متغیر در محدوده‌ی فعلی تعریف نشده است.

global (گلوبال): سراسری؛ دیده‌شدنی در همه‌جای برنامه

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

Avoid global variables when a parameter can do the job.

وقتی یک پارامتر کار را راه می‌اندازد، سراغ متغیر سراسری نرو.

local (لوکال): محلی؛ فقط در همین‌جا

local یعنی «مربوط به همین محل». متغیر local فقط داخل تابعی که در آن ساخته شده وجود دارد و با تمام شدن تابع از بین می‌رود. معنی دوم و پرکاربردش: «روی کامپیوتر خودم»، در برابر سرور. localhost یعنی همین کامپیوتری که پشتش نشسته‌ای.

It works on my local machine but not on the server.

روی کامپیوتر خودم کار می‌کند ولی روی سرور نه.

nested (نِستِد): تودرتو

nest یعنی «لانه‌ی پرنده» و nested یعنی «جاگرفته درون چیز دیگر»، مثل عروسک‌های روسی که هر کدام داخل قبلی است. در کد: حلقه‌ای درون حلقه‌ی دیگر، if درون if، یا فهرستی که خانه‌هایش خودشان فهرست هستند.

Use a nested loop to print every row and column.

برای چاپ هر ردیف و ستون از یک حلقه‌ی تودرتو استفاده کن.

block (بلاک): بلوک؛ چند خط کد که با هم یک تکه‌اند

block در انگلیسی یعنی «قطعه، تکه»، مثل آجر اسباب‌بازی. در برنامه به چند خط کد می‌گویند که با هم یک واحد می‌سازند: بدنه‌ی یک if، یک حلقه یا یک تابع. در پایتون بلوک با تورفتگی مشخص می‌شود و در جاوااسکریپت با { و }.

The code inside the if block runs only once.

کد داخل بلوک if فقط یک بار اجرا می‌شود.

یک خطای واقعی و توضیحش

TypeError: greet() missing 1 required positional argument: 'name'

This error means the function has a parameter called name, but you called it without an argument. Write greet("Sara") instead of greet().

Also remember that name is a local variable. It exists only inside the function block. If you try to print it outside, in the global scope, Python will not find it. Return the result from the function if you need it later.

TypeError: تابع greet() یک آرگومان جایگاهی لازم کم دارد: name

این خطا یعنی تابع پارامتری به اسم name دارد، ولی تو آن را بدون آرگومان صدا زده‌ای. به جای greet() بنویس greet("Sara").

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