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

فعل‌های اصلی

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

فعل برای تابع، اسم برای متغیر

تابع یک کار انجام می‌دهد، پس اسمش با فعل شروع می‌شود: getUser()، createFile()، updateScore(). متغیر یک چیز را نگه می‌دارد، پس اسمش اسم است: user، file، score. اسم‌هایی که با is، has و can شروع می‌شوند یک سؤال بله یا نه‌اند و جوابشان true یا false است: is_empty (خالی است؟)، has_key (کلید دارد؟)، can_edit (می‌تواند ویرایش کند؟).

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

get (گِت): گرفتن، به دست آوردن

get در انگلیسی یعنی «گرفتن». وقتی اسم تابعی با get شروع می‌شود، خواننده انتظار دارد آن تابع چیزی را به تو بدهد و هیچ چیز را عوض نکند: getUser() کاربر را برمی‌گرداند، getPrice() قیمت را. اگر تابعی که اسمش get دارد چیزی را پاک کند یا تغییر بدهد، اسمش دروغ گفته است.

This function gets the user name from the database.

این تابع نام کاربر را از پایگاه داده می‌گیرد.

set (سِت): گذاشتن یک مقدار، تنظیم کردن

set یعنی «گذاشتن» یا «تنظیم کردن»، مثل تنظیم کردن ساعت زنگ‌دار. تابعی که اسمش با set شروع می‌شود یک مقدار تازه می‌گیرد و آن را جای مقدار قبلی می‌گذارد: setName("Sara") اسم را عوض می‌کند. خواننده از چنین تابعی انتظار تغییر دارد، نه جواب.

Call setVolume() to set the volume to a new value.

برای گذاشتن مقدار تازه روی صدا، setVolume() را صدا بزن.

is (ایز): هست، است (شروع اسم‌های بله یا نه)

is همان «است» فارسی است. اسمی که با is شروع می‌شود در واقع یک سؤال بله یا نه است: is_empty یعنی «خالی است؟»، isReady یعنی «آماده است؟». پس خواننده مطمئن است که جوابش فقط true یا false است، نه عدد و نه متن. بعد از is معمولاً یک صفت می‌آید.

The function returns true if the list is empty.

اگر فهرست خالی باشد، تابع true برمی‌گرداند.

has (هَز): دارد (شروع اسم‌های «آیا دارد؟»)

has یعنی «دارد» و شکل سوم‌شخص فعل have است. اسمی که با has شروع می‌شود می‌پرسد «آیا این چیز فلان چیز را دارد؟» و جوابش true یا false است: has_key می‌پرسد کلید هست یا نه، hasChildren می‌پرسد بچه دارد یا نه. بعد از has یک اسم می‌آید، نه صفت.

Check if the user has permission to edit this file.

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

can (کَن): می‌تواند (شروع اسم‌های «آیا اجازه دارد؟»)

can یعنی «توانستن». اسمی که با can شروع می‌شود می‌پرسد «آیا این کار شدنی یا مجاز است؟» و جوابش true یا false است: canEdit یعنی «می‌تواند ویرایش کند؟»، can_jump یعنی «می‌تواند بپرد؟». این اسم‌ها را بیشتر در بررسی اجازه‌ها و قانون‌های بازی می‌بینی.

Only admins can delete other users.

فقط مدیرها می‌توانند کاربرهای دیگر را حذف کنند.

make (مِیک): ساختن، درست کردن

make یعنی «ساختن»، مثل make a cake، کیک درست کردن. تابعی که اسمش با make شروع می‌شود چیزی را از تکه‌هایی که به آن می‌دهی سر هم می‌کند و تحویل می‌دهد: make_title(text) از یک متن عنوان می‌سازد. make خودمانی‌تر از create است و بیشتر برای ساختن چیزهای کوچک به کار می‌رود.

This helper makes a full name from the first and last name.

این تابع کمکی از نام و نام خانوادگی یک نام کامل می‌سازد.

create (کِری‌اِیت): ایجاد کردن، چیز تازه ساختن

create یعنی «به وجود آوردن» چیزی که قبلاً نبود. تابعی مثل createUser() یک کاربر تازه می‌سازد و معمولاً آن را جایی هم ذخیره می‌کند. خواننده انتظار دارد بعد از صدا زدنش یک چیز تازه در برنامه، پایگاه داده یا روی دیسک باشد. حرف C در CRUD همین create است.

Click the button to create a new project.

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

update (آپدِیت): به‌روز کردن

update از up و date ساخته شده: «تاریخ چیزی را بالا آوردن»، یعنی آن را به‌روز کردن. تابعی مثل updateProfile() چیزی را که از قبل هست تغییر می‌دهد و چیز تازه نمی‌سازد. فرقش با set این است که set یک مقدار را کامل جایگزین می‌کند، ولی update معمولاً فقط بخش‌هایی را عوض می‌کند.

Please update your browser to the latest version.

لطفاً مرورگرت را به آخرین نسخه به‌روز کن.

راهنمای اسم‌گذاری یک تیم

Naming guide for our team

A function name starts with a verb. Use get when the function only reads a value, and set when it changes one. Use create to make a new thing, and update to change a thing that already exists.

A name that starts with is, has or can must return true or false. For example, isAdmin() tells you if the user is an admin, hasEmail() tells you if the user has an email, and canEdit() tells you if the user can edit the page.

راهنمای اسم‌گذاری تیم ما

اسم تابع با یک فعل شروع می‌شود. وقتی تابع فقط یک مقدار را می‌خواند get به کار ببر و وقتی آن را عوض می‌کند set. برای ساختن یک چیز تازه create به کار ببر و برای عوض کردن چیزی که از قبل هست update.

اسمی که با is، has یا can شروع می‌شود باید true یا false برگرداند. مثلاً isAdmin() می‌گوید کاربر مدیر است یا نه، hasEmail() می‌گوید کاربر ایمیل دارد یا نه، و canEdit() می‌گوید کاربر می‌تواند صفحه را ویرایش کند یا نه.