https://python.iotwithiman.com/docs/part01/ch08/ Recent content in تابع‌ها on کتاب Python Crash Course Hugo fa-IR https://python.iotwithiman.com/docs/part01/ch08/p01/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p01/ <p>در این فصل نوشتنِ <em>تابع‌ها</em> را یاد می‌گیرید. توابع قسمت‌های نام‌گذاری‌شده‌ی کد هستند که برای انجام کار خاصّی طرّاحی می‌شوند. وقتی می‌خواهید وظیفه‌ی خاصّی را که در یک تابع تعریف شده انجام دهید، تابعی را که عهده‌دار آن است <em>فراخوانی</em> می‌کنید. اگ <span class="fn-ref" data-fn="66">⁶⁶</span> ر به انجامِ چندباره‌ی کاری نیاز داشته باشید، نیازی نیست کد آن را بارها تکرار کنید، کافی است تابعی را که به مدیریّت این کار اختصاص داده‌اید فراخوانی کنید و این فراخوانی موجب می‌شود که پایتون کد داخل تابع را اجرا کند. شما درخواهید یافت که به‌کارگیری تابع‌ها نوشتن، خواندن، آزمایش و رفع عیب برنامه‌های شما را آسان‌تر می‌کند.</p> https://python.iotwithiman.com/docs/part01/ch08/p02/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p02/ <p>با کمی تغییر، تابعِ <code>greet_user()</code> نه تنها به کاربر سلام می‌کند، بلکه می‌تواند نام او را هم ذکر کند. برای این که تابع چنین کند <code>username</code> را در پرانتزهای تعریفِ تابع در <code>def greet_user()</code> می‌نویسید. با افزودن <code>username</code> به آن‌جا، تابع را قادر می‌سازید که هر مقدار <code>username</code>ای که تعیین می‌کنید، بپذیرد. اکنون پایتون انتظار دارد که در هر بار فراخوانیِ تابع، مقداری برای <code>username</code> ارائه دهید. هنگامی که <code>greet_user()</code> را فرامی‌خوانید می‌توانید در پرانتزهای آن، نامی مانند <code>'jesse'</code> را به این تابع بدهید:</p> https://python.iotwithiman.com/docs/part01/ch08/p03/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p03/ <p>فراخوانی یک تابع ممکن است به نشان‌ونن<span class="fn-ref" data-fn="73">⁷³</span> یاز داشته باشد زیرا تعریف تابع ممکن است شامل چند پارامتر باشد. چند راه برای انتقال نشان‌وندها به تابع‌ها دارید. می‌توانید از <em>نشان‌وندهای مکان‌دار</em> استفاده کنید که هنگام انتقال به تابع باید با همان ترتیبِ تعریف شدهِ پارامترها وارد شوند. در <em>نشان‌وندهای کلیدواژه‌ای</em> هر نشان‌وند از نام متغیّر و یک مقدار، لیست یا دیکشنری‌هایی از مقدارها تشکیل شده است. در ادامه به هر یک از این دو مورد خواهیم پرداخت.</p> https://python.iotwithiman.com/docs/part01/ch08/p04/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p04/ <p>دلیلی ندارد که تابع همیشه خروجی را به طور مستقیم نمایش دهد. در عوض می‌تواند داده‌هایی را پردازش کند و مقدار یا مجموعه‌ای از مقدارها را برگرداند. به مقداری که تابع برمی‌گرداند <em>مقدار برگشتی</em> گویند. عبارت <code>return</code> مقداری را از داخل تابع می‌گیرد و به همان خطّی که تابع در آن فراخوانی شده بود برمی‌گرداند. با مقدارهای برگشتی می‌توان بخش زیادی از کارهای برنامه را به تابع‌ها منتقل کرد که این، باعث ساده‌تر شدن بدنه‌ی برنامه‌ی شما می‌شود.</p> https://python.iotwithiman.com/docs/part01/ch08/p05/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p05/ <p>انتقال لیست‌ها به یک تابع غالباً کاری سودمند است، چه لیستی از نام‌ها باشد، چه اعداد یا چیزهای پیچیده‌تر مثل دیکشنری‌ها. زمانی که لیستی را به تابعی می‌دهید، تابع به محتویّات آن دسترسی مستقیم دارد. اکنون از تابع‌ها برای کار کردن کارآمدتر با لیست‌ها استفاده می‌کنیم.</p> <p>فرض کنید که لیستی از کاربران داریم و می‌خواهیم به هر کدامشان سلام کنیم. مثال زیر لیستی از نام‌ها را به تابعی به نام <code>greet_users()</code> می‌فرستد که به هر کدام از افراد داخل لیست به طور جداگانه سلام می‌کند.</p> https://python.iotwithiman.com/docs/part01/ch08/p06/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p06/ <p>گاهی از تعداد نشان‌وندهایی که یک تابع نیاز دارد، از پیش اطّلاع ندارید. خوشبختانه پایتون این امکان را می‌دهد که تابع تعداد دلخواهی نشان‌وند را هنگام فراخوانی دریافت کند.</p> <p>برای مثال تابعی را در نظر بگیرید که پیتزا درست می‌کند. این تابع به تعداد مواد روی پیتزا نیاز دارد ولی شما از پیش نمی‌دانید که فرد چه تعدادی از این مواد را درخواست می‌کند. تابع مثال زیر یک پارامتر دارد، <code>*toppings</code>، امّا این پارامترها تمام نشان‌وندهایی را که در خط فراخوانی ارائه می‌شود، جمع‌آوری می‌کند:</p> https://python.iotwithiman.com/docs/part01/ch08/p07/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p07/ <p>یکی از سودمندی‌های تابع‌ها این است که بخش‌های مختلف کد را از برنامه‌ی اصلی شما جدا می‌کند. با انتخاب نام‌های گویا برای تابع‌های خود، دنبال کردن برنامه‌ی اصلی شما بسیار ساده‌تر خواهد بود. می‌توانید یک گام فراتر بروید و تابع‌های خود را در فایلی جداگانه به نام <em>ماژول</em> ذخیره و سپس آن ماژول را در برنامه‌ی اصلی خود <em>وارد کنید</em>. عبارت <code>import</code> از پایتون می‌خواهد که کد موجود در ماژول را در فایل برنامه‌ای که اکنون در حال اجراست، در اختیار قرار دهد.</p> https://python.iotwithiman.com/docs/part01/ch08/p08/ Mon, 01 Jan 0001 00:00:00 +0000 https://python.iotwithiman.com/docs/part01/ch08/p08/ <p>باید برخی جزئیات را هنگام شکل دادن به تابع‌ها در نظر داشته باشید. نام تابع‌ها باید گویا باشد و در آن‌ها از حروف کوچک و زیرخط استفاده شود. نام‌های گویا و بامعنی به شما و دیگران کمک می‌کند که بفهمید کد چه کاری انجام می‌دهد. نام ماژول‌ها هم باید از چنین قواعدی پیروی کنند.</p> <p>هر تابع باید توضیحی داشته باشد که مختصراً بگوید تابع چه می‌کند. این توضیح باید بلافاصله بعد از تعریفِ تابع و به شکل docstring بیاید. اگر تابع به درستی مستند شده باشد، برنامه‌نویسان دیگر می‌توانند تنها با خواندن توضیحات موجود در docstring از آن استفاده کنند. آن‌ها باید قادر باشند که به کارکرد کد همانگونه که شرح داده شده اعتماد کنند و مادامی‌که بدانند نام تابع، نشان‌وندهایی که نیاز دارد و نوع مقداری که برمی‌گرداند، چیست باید بتوانند از آن در برنامه‌های خود استفاده کنند.</p>