توضیحات در پایتون – به زبان ساده

۳۵۷۴ بازدید
آخرین به‌روزرسانی: ۱۳ خرداد ۱۴۰۳
زمان مطالعه: ۳ دقیقه
دانلود PDF مقاله
توضیحات در پایتون – به زبان سادهتوضیحات در پایتون – به زبان ساده

در مطلب «زبان برنامه نویسی پایتون (Python) — از صفر تا صد» که پیش‌تر در مجله فرادرس منتشر شده بود، به چیستی «زبان برنامه‌نویسی پایتون» (Python Programming Language)، دلایل محبوبیت، ویژگی‌ها، مزایا و معایب، کاربردها، بازار کار، نسخه‌های مختلف زبان پایتون (۲ و ۳) و روش انتخاب نسخه مناسب و تفاوت‌های این زبان با دیگر زبان‌های برنامه‌نویسی پرداخته شد. همچنین، در مطلب «پایتون برای مبتدیان — به زبان ساده» مباحث مقدماتی پایتون شامل روش نصب مقدماتی و اجرای آن و همچنین، روش نوشتن برنامه «Hello World!‎» برای افراد مبتدی مورد بررسی قرار گرفت. در مطلبی با عنوان «کلیدواژه‌ها و شناساگرها در پایتون — به زبان ساده» به موضوع «کلمات رزرو شده» (Reserved Words)، «کلیدواژه‌ها» (Keywords) و «شناساگرها» (Identifier) پرداخته شد. در مطلب «دستورات پایتون و دندانه‌گذاری — به زبان ساده» به مفهوم دستور در پایتون و روش دندانه‌گذاری هنگام نوشتن دستورات پرداخته شد. در این مطلب، به مفهوم توضیحات در پایتون پرداخته می‌شود. برای یادگیری روش نصب پایتون در سیستم‌عامل‌های گوناگون، مطالعه راهنماهای جامع و تصویری زیر توصیه می‌شود.

997696

توضیحات در پایتون

استفاده از «توضیحات» (Comments) ضمن نوشتن برنامه بسیار حائز اهمیت است. توضیحات همانطور که از نام آن پیداست، توضیحی را پیرامون کد ارائه می‌کند و در واقع نشان می‌دهد که یک دستور چه کار می‌کند و یا درون یک برنامه چه می‌گذرد؛ اما خود توضیحات در پایتون جزوی از کد قابل اجرا محسوب نمی‌شود. با افزودن توضیحات به کد، هنگامی که فردی به کد منبع یک برنامه نگاه می‌کند، بدون نیاز به صرف زمان زیاد برای درک آنچه در آن کد به وقوع پیوسته می‌تواند از ساز و کار آن آگاه شود.

کاربر ممکن است جزئیات کلیدی برنامه‌ای را که مدت‌ها پیش نوشته است، فراموش کند. نوشتن توضیحات در برنامه، کمک می‌کند تا فرد هر بار که کد خود را باز می‌کند، به سرعت و سادگی متوجه شود که در بخش‌های مختلف آن چه اتفاقی می‌افتد. بنابراین، تخصیص زمان به نوشتن توضیحات در پایتون (ضمن نوشتن برنامه)، بسیار مفید و ثمربخش خواهد بود.

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

توضیحات چند خطی

اگر توضیحات در پایتون طولانی است و در چند خط ادامه پیدا می‌کند، راهکارهای مختلفی برای نوشتن آن وجود دارد. ساده‌ترین راه همانطور که پیش از این نیز بیان شد، استفاده از علامت هش (#) در آغاز هر خط است. مثال زیر در این راستا قابل توجه است.

راهکار دیگر، استفاده از سه علامت «نقل قول» (Quotes) انگلیسی به صورت ''' یا """ است. این علامت‌های نقل قول سه تایی به طور کلی برای رشته‌های چند خطی مورد استفاده قرار می‌گیرند. در صورتی که توضیحات «داک‌استرینگ» (Docstrings) نباشد، هیچ کد اضافی ایجاد نخواهند کرد. در ادامه، مفهوم داک‌استرینگ در پایتون تشریح خواهد شد.

«داک‌استرینگ» (Docstring) در پایتون

داک‌استرینگ، مخفف «داکیومنتیشن استرینگ» (Documentation String) است. داک‌استرینگ، رشته‌ای است که به عنوان اولین دستور در یک «ماژول» (Module)، «تابع» (Function)، «کلاس» (Class) و یا تعریف «متد» (Method) به قرار می‌گیرد. کاربر باید در داک‌استرینگ بنویسد که یک تابع/کلاس چه کاری انجام می‌دهد.

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

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

اگر نوشته بالا برای شما مفید بوده است، آموزش‌های زیر نیز به شما پیشنهاد می‌شوند:

^^

بر اساس رای ۰ نفر
آیا این مطلب برای شما مفید بود؟
اگر بازخوردی درباره این مطلب دارید یا پرسشی دارید که بدون پاسخ مانده است، آن را از طریق بخش نظرات مطرح کنید.
منابع:
Programiz
دانلود PDF مقاله
۱ دیدگاه برای «توضیحات در پایتون – به زبان ساده»

آموزش مفید و کوتاهی بود ، خیلی ممنونم 🙂

نظر شما چیست؟

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *