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

تابع‌ها، عمیق‌تر

تابع را بلدی؛ این درس کلمه‌هایی را یاد می‌دهد که برنامه‌نویس‌ها برای حرف زدن درباره‌ی شکل و رفتار تابع‌ها به کار می‌برند، در مستندات و در code review.

no + اسم، not + فعل

برای منفی کردن یک اسم no می‌آید: It has no side effects (هیچ اثر جانبی ندارد). برای منفی کردن فعل، not بعد از does یا is می‌آید: It does not change the cart. جمله‌ی It has not side effects غلط است.

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

recursive function (ریکِرسیو فانکشِن): تابعی که خودش را صدا می‌زند

recur یعنی «دوباره رخ دادن». recursive function تابعی است که برای حل مسئله، خودش را با ورودی کوچک‌تری صدا می‌زند، تا جایی که مسئله آن‌قدر ساده شود که جوابش معلوم باشد؛ به این نقطه base case می‌گویند. برای کار با درخت، پوشه‌های تو در تو و مسئله‌هایی مثل فاکتوریل خیلی طبیعی است.

A recursive function always needs a base case, or it never stops.

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

higher-order function (هایِر اُردِر فانکشِن): تابعی که تابع می‌گیرد یا تابع برمی‌گرداند

higher-order یعنی «از مرتبه‌ی بالاتر». higher-order function تابعی است که با تابع‌های دیگر کار می‌کند: یا یک تابع را به‌عنوان آرگومان می‌گیرد، یا یک تابع تازه برمی‌گرداند. map، filter و sorted با key نمونه‌های معروفش در پایتون هستند و decoratorها هم همین‌طور.

map is a higher-order function because it takes another function.

map یک تابع مرتبه‌بالاست، چون یک تابع دیگر را می‌گیرد.

pure function (پیوْر فانکشِن): تابعی که فقط از ورودی‌اش جواب می‌سازد و چیزی را عوض نمی‌کند

pure یعنی «خالص» یا «پاک». pure function تابعی است که دو قانون دارد: با ورودی یکسان همیشه خروجی یکسان می‌دهد، و هیچ چیز بیرون از خودش را عوض نمی‌کند؛ نه متغیر سراسری، نه فایل، نه صفحه. مثل ماشین‌حساب: 2 + 3 هر بار 5 است. تست کردن و فهمیدن این تابع‌ها خیلی ساده‌تر است.

Keep your helpers as pure functions so they are easy to test.

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

side effect (ساید ایفِکت): اثر جانبی؛ تغییری که تابع بیرون از خودش می‌گذارد

side effect در پزشکی یعنی «عارضه‌ی جانبی» یک دارو: کار اصلی‌اش را می‌کند، ولی اثر دیگری هم دارد. در برنامه‌نویسی هر کاری است که تابع غیر از برگرداندن جواب انجام می‌دهد: چاپ روی صفحه، نوشتن در فایل، عوض کردن یک متغیر سراسری یا یک لیست، فرستادن درخواست. بدون side effect برنامه کار مفیدی نمی‌کند، ولی باید بدانی کجا هستند.

This function has a side effect: it also changes the original list.

این تابع یک اثر جانبی دارد: لیست اصلی را هم عوض می‌کند.

anonymous function (اَنانِمِس فانکشِن): تابع بی‌اسم

anonymous یعنی «ناشناس» یا «بی‌نام»، مثل نامه‌ای که امضا ندارد. anonymous function تابعی است که اسمی ندارد و معمولاً همان‌جا که لازم است نوشته و به تابع دیگری داده می‌شود. در پایتون با lambda ساخته می‌شود و فقط یک عبارت دارد؛ در جاوااسکریپت با arrow function یا function بدون اسم.

Pass an anonymous function to sort the users by age.

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

return value (ریتِرن وَلیو): مقداری که تابع برمی‌گرداند

return یعنی «برگرداندن» و value یعنی «مقدار». return value همان جوابی است که تابع بعد از کارش پس می‌دهد و می‌توانی در یک متغیر بگذاری یا مستقیم استفاده کنی. اگر تابع return نداشته باشد، در پایتون None و در جاوااسکریپت undefined برمی‌گرداند. یادت باشد چاپ کردن با برگرداندن یکی نیست.

Check the return value before you use it; it may be None.

قبل از استفاده، مقدار برگشتی را چک کن؛ ممکن است None باشد.

signature (سیگنِچِر): امضای تابع: اسم، پارامترها و نوع خروجی‌اش

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

The signature changed in version 2, so old calls now fail.

امضای تابع در نسخه‌ی ۲ عوض شد، برای همین صدا زدن‌های قدیمی حالا خطا می‌دهند.

overload (اُوِرلود): برای یک تابع یا عملگر چند نسخه با ورودی‌های مختلف ساختن

overload در انگلیسی یعنی «بیش از اندازه بار زدن»، مثل کامیونی که بارش زیاد است. در برنامه‌نویسی یعنی یک اسم تابع یا یک عملگر را برای چند جور ورودی تعریف کنی و زبان از روی آرگومان‌ها نسخه‌ی درست را انتخاب کند. در Java و C++ رایج است؛ در پایتون تعریف دوم اولی را پاک می‌کند، ولی با dunder methodها می‌شود عملگری مثل + را overload کرد.

Python lets you overload the + operator with the __add__ method.

پایتون اجازه می‌دهد عملگر + را با متد __add__ برای کلاس خودت تعریف کنی.

توضیح یک تابع در مستندات

apply_discount(price, percent)

Return value: the new price as a float.

This is a pure function. It has no side effects: it does not change the cart or the database, so it is easy to test.

The signature changed in version 2.0: the old version also took a callback. If you need a different rule, pass your own function to apply_rule(), which is a higher-order function. You can also pass an anonymous function, for example lambda p: p * 0.9.

apply_discount(price, percent)

مقدار برگشتی: قیمت تازه به‌شکل عدد اعشاری.

این یک تابع خالص است. هیچ اثر جانبی ندارد: نه سبد خرید را عوض می‌کند و نه پایگاه داده را، پس تست کردنش آسان است.

امضای این تابع در نسخه‌ی ۲.۰ عوض شد: نسخه‌ی قدیمی یک callback هم می‌گرفت. اگر قانون دیگری لازم داری، تابع خودت را به apply_rule بده که یک تابع مرتبه‌بالاست. می‌توانی یک تابع بی‌اسم هم بدهی، مثلاً lambda p: p * 0.9.