KAHIBARO Bookshelves
Discord Login Register

9.2. تعریف توابع

ساختار کلی تعریف تابع در پایتون

در این بخش تمرکز ما روی «نحوهٔ نوشتن» توابع است، نه این‌که چرا لازم‌اند یا چطور دوباره استفاده می‌شوند (این‌ها در بخش‌های دیگر فصل توضیح داده می‌شوند).

ساختار کلی یک تابع در پایتون این‌گونه است:

def نام_تابع(لیست_پارامترها):
    دستور_۱
    دستور_۲
    ...

نکته‌های مهم در این ساختار:

  • کلمهٔ کلیدی def همیشه ابتدای تعریف تابع می‌آید.
  • بعد از نام تابع، پرانتز () قرار می‌گیرد (حتی اگر پارامتری نداشته باشد).
  • تعریف تابع با : (دو نقطه) تمام می‌شود.
  • تمام کدهای داخل تابع باید با فاصله (indent) تو رفته باشند (معمولاً ۴ فاصلهٔ خالی یا یک تب).
  • بیرون آمدن از تو رفتگی یعنی «کد دیگر داخل آن تابع نیست».

یک تابع ساده بدون پارامتر

ساده‌ترین نوع تابع، تابعی است که ورودی نمی‌گیرد:

def salam():
    print("سلام! به دنیای پایتون خوش آمدی.")
# فراخوانی تابع
salam()

نکات:

  • salam نام تابع است.
  • () نشان می‌دهد این نام، یک تابع است و باید «فراخوانی» شود.
  • بدون () شما فقط به خودِ تابع اشاره می‌کنید، نه اجرای آن:
    • salam → فقط اشاره به تابع
    • salam() → اجرای تابع

نام‌گذاری توابع

چند قانون و توصیهٔ مهم برای نام‌گذاری:

قوانین (الزامی):

  • فقط می‌توان از حروف (a-z, A-Z)، عددها (0-9) و زیرخط (_) استفاده کرد.
  • نام تابع نباید با عدد شروع شود.
  • فاصله (space) مجاز نیست.
  • استفاده از کلمات رزرو‌شدهٔ پایتون مثل def, if, for, while به عنوان نام تابع ممنوع است.

توصیه‌ها (برای کد خوانا):

  • از نام‌های معنادار استفاده کنید:
    • بد: f1, x
    • خوب: print_welcome, calculate_area
  • معمولاً برای توابع از حالت snake_case استفاده می‌شود:
    • حروف کوچک + جدا کردن کلمات با _:
      • print_menu, get_user_name, save_to_file

چند مثال:

def print_menu():
    print("1. جمع")
    print("2. تفریق")
def get_age():
    print("لطفاً سن خود را وارد کنید:")

بدنهٔ تابع و تورفتگی (Indentation)

هر چیزی که داخل تابع است، باید زیر تعریف تابع تو رفته باشد. این تو رفتگی است که محدودهٔ تابع را مشخص می‌کند، نه {} مثل بعضی زبان‌های دیگر.

مثال درست:

def show_message():
    print("سلام")
    print("این یک پیام است")

مثال نادرست (بدون تو رفتگی):

def show_message():
print("سلام")
print("این یک پیام است")

کد بالا خطای IndentationError می‌دهد، چون پایتون انتظار دارد کدهای داخل تابع با فاصله شروع شوند.

نکات عملی:

  • از اول دوره بهتر است همیشه ۴ فاصله برای هر سطح تو رفتگی استفاده کنید.
  • در ویرایشگرها معمولاً با زدن کلید Tab، ۴ فاصله قرار داده می‌شود (بسته به تنظیمات IDE).

تابعی که فقط کاری انجام می‌دهد (بدون مقدار بازگشتی)

بعضی توابع فقط کاری را انجام می‌دهند (مثلاً چاپ متن) و مقدار خاصی برنمی‌گردانند. این نوع توابع را گاهی «رویه» (procedure) می‌نامند.

مثال:

def print_welcome_message():
    print("************************")
    print("   برنامه مدیریت کارها  ")
    print("************************")
print_welcome_message()

این تابع:

  • چیزی از کاربر نمی‌گیرد (پارامتر ندارد).
  • چیزی هم به برنامه برنمی‌گرداند؛ فقط روی خروجی چاپ می‌کند.

تابع خالی (استفاده از `pass`)

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

def todo_list():
    # بعداً منطق برنامه اینجا نوشته می‌شود
    pass

pass یعنی: «اینجا عمداً هیچ کاری نکن».

این روش زمانی مفید است که دارید اسکلت کلی برنامه را طراحی می‌کنید و بعداً جزئیات را پر می‌کنید.

داک‌استرینگ (توضیح تابع)

برای تابع می‌توانید در خط اول بدنهٔ آن، یک رشتهٔ چندخطی بنویسید تا توضیح دهد که این تابع چه کار می‌کند. به این توضیح، docstring گفته می‌شود.

def greet():
    """این تابع یک پیام خوشامد چاپ می‌کند."""
    print("سلام! خوش آمدی :)")
greet()

نکات:

  • داک‌استرینگ بین سه‌تایی دابل‌کوتیشن """ یا سینگل‌کوتیشن ''' نوشته می‌شود.
  • در خط اول بعد از تعریف تابع و داخل بدنهٔ آن قرار می‌گیرد.
  • بعداً می‌توانید با help(نام_تابع) این توضیح را ببینید (این در فصل کتابخانه‌ها و کمک بیشتر به کار خواهد آمد).

مثال کمی مفصل‌تر:

def print_user_info():
    """
    اطلاعات کاربر را روی صفحه چاپ می‌کند.
    فعلاً فقط یک متن نمونه نمایش داده می‌شود.
    """
    print("نام: کاربر نمونه")
    print("سن: 20")

تعریف تابع و فراخوانی در جاهای مختلف فایل

معمولاً توابع را در ابتدای فایل (بعد از ایمپورت‌ها) تعریف می‌کنند و بعد در ادامهٔ برنامه آن‌ها را فراخوانی می‌کنند.

الگوی رایج:

def show_header():
    print("==== برنامه نمونه ====")
def main():
    show_header()
    print("اینجا بقیهٔ منطق برنامه قرار می‌گیرد.")
# شروع اجرای برنامه
main()

چیزهایی که در این مرحله لازم است بدانید:

  • یک تابع می‌تواند تابع دیگری را فراخوانی کند (مثل main که show_header را صدا می‌زند).
  • پایتون قبل از اجرای خطوط پایین‌تر، باید «تعریف تابع» را بالاتر دیده باشد. برای همین معمولاً تعریف توابع بالای فایل نوشته می‌شود.

اشتباهات رایج در تعریف تابع

در این بخش فقط اشتباه‌های مربوط به «تعریف تابع» را می‌بینیم (نه منطق داخلی تابع):

۱. فراموش کردن `:`

def say_hello()   # نادرست
    print("سلام")

باید این‌طور باشد:

def say_hello():
    print("سلام")

۲. ننوشتن پرانتزها

def say_hello:    # نادرست
    print("سلام")

باید حتماً () وجود داشته باشد، حتی اگر پارامتری نیست:

def say_hello():
    print("سلام")

۳. فضای خالی اشتباه قبل از `def`

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

مثال نادرست:

 if True:
def f():
    print("سلام")

۴. استفاده از نام نامعتبر

def 2print():   # نادرست - شروع با عدد
    print("عدد")
def print message():  # نادرست - وجود فاصله
    print("پیام")

نسخهٔ درست:

def print2():
    print("عدد")
def print_message():
    print("پیام")

چند تمرین پیشنهادی

برای تمرین تعریف تابع (بدون درگیر شدن با پارامتر و مقدار بازگشتی)، می‌توانید این کارها را انجام دهید:

  1. تابعی بنویسید به نام print_line که یک خط شامل ---------- چاپ کند و آن را چند بار در برنامه صدا بزنید.
  2. تابعی بنویسید به نام show_menu که منوی یک برنامهٔ خیالی را چاپ کند (مثلاً «۱. افزودن»، «۲. حذف»، «۳. خروج») و بعد آن را فراخوانی کنید.
  3. تابعی بنویسید به نام about_me که دو سه خط دربارهٔ شما (نام، شهر و یک علاقهٔ شخصی) چاپ کند.

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

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

Where to Move

Move chapter:

  • ☰ 1. فصل ۱: برنامه‌نویسی چیست؟
    • ☰ 1.1. برنامهٔ کامپیوتری چیست؟
      • ☰ 1.2. پایتون چیست؟
        • ☰ 1.3. پایتون کجا استفاده می‌شود؟
          • ☰ 1.4. چگونه برنامه‌نویسی به حل مسائل کمک می‌کند
            • ☰ 1.5. اولین برنامهٔ پایتون شما
            • ☰ 2. فصل ۲: راه‌اندازی پایتون
              • ☰ 2.1. نصب پایتون (ویندوز / macOS / لینوکس)
                • ☰ 2.2. استفاده از پایتون در ترمینال
                  • ☰ 2.3. استفاده از یک IDE (IDLE / VS Code)
                    • ☰ 2.4. اجرای اسکریپت‌های پایتون
                      • ☰ 2.5. حالت تعاملی پایتون
                      • ☰ 3. فصل ۳: متغیرها و انواع داده
                        • ☰ 3.1. متغیر چیست؟
                          • ☰ 3.2. ایجاد متغیرها
                            • ☰ 3.3. اعداد (`int`، `float`)
                              • ☰ 3.4. متن (`str`)
                                • ☰ 3.5. مقادیر بولی (`True`، `False`)
                                  • ☰ 3.6. بررسی نوع داده با `type()`
                                  • ☰ 4. فصل ۴: عملیات پایه
                                    • ☰ 4.1. عملیات حسابی
                                      • ☰ 4.2. کار با اعداد
                                        • ☰ 4.3. عملیات روی رشته‌ها
                                          • ☰ 4.4. ترکیب متن و متغیرها
                                            • ☰ 4.5. کامنت‌ها در پایتون
                                            • ☰ 5. فصل ۵: ورودی و خروجی کاربر
                                              • ☰ 5.1. دریافت ورودی از کاربر
                                                • ☰ 5.2. تبدیل ورودی به عدد
                                                  • ☰ 5.3. قالب‌بندی خروجی
                                                    • ☰ 5.4. نوشتن برنامه‌های تعاملی
                                                    • ☰ 6. فصل ۶: شرط‌ها (if / else)
                                                      • ☰ 6.1. عملگرهای مقایسه‌ای
                                                        • ☰ 6.2. عملگرهای منطقی
                                                          • ☰ 6.3. if، elif، else
                                                            • ☰ 6.4. شرط‌های تو در تو
                                                              • ☰ 6.5. اشتباهات رایج مبتدیان
                                                              • ☰ 7. فصل ۷: حلقه‌ها
                                                                • ☰ 7.1. چرا حلقه‌ها مفید هستند؟
                                                                  • ☰ 7.2. حلقه‌های while
                                                                    • ☰ 7.3. حلقه‌های for
                                                                      • ☰ 7.4. شمارنده‌های حلقه
                                                                        • ☰ 7.5. break و continue
                                                                          • ☰ 7.6. تمرین‌های حلقه
                                                                          • ☰ 8. فصل ۸: مجموعه‌های داده
                                                                            • ☰ 8.1. لیست‌ها (Lists)
                                                                              • ☰ 8.2. تاپل‌ها (Tuples)
                                                                                • ☰ 8.3. دیکشنری‌ها (Dictionaries)
                                                                                  • ☰ 8.4. مجموعه‌ها (Sets – مقدماتی)
                                                                                    • ☰ 8.5. انتخاب ساختار دادهٔ مناسب
                                                                                    • ☰ 9. فصل ۹: توابع
                                                                                      • ☰ 9.1. چرا توابع مهم هستند؟
                                                                                        • ☰ 9.2. تعریف توابع
                                                                                          • ☰ 9.3. پارامترها و آرگومان‌ها
                                                                                            • ☰ 9.4. مقادیر بازگشتی
                                                                                              • ☰ 9.5. محدودهٔ متغیرها (محلی در برابر سراسری)
                                                                                                • ☰ 9.6. استفادهٔ مجدد از کد
                                                                                                • ☰ 10. فصل ۱۰: کار با فایل‌ها
                                                                                                  • ☰ 10.1. فایل چیست؟
                                                                                                    • ☰ 10.2. خواندن فایل‌های متنی
                                                                                                      • ☰ 10.3. نوشتن و افزودن به فایل‌ها
                                                                                                        • ☰ 10.4. مسیر فایل‌ها
                                                                                                          • ☰ 10.5. برنامه‌های ساده مبتنی بر فایل
                                                                                                          • ☰ 11. فصل ۱۱: خطاها و اشکال‌زدایی
                                                                                                            • ☰ 11.1. انواع خطاها
                                                                                                              • ☰ 11.2. خواندن پیام‌های خطا
                                                                                                                • ☰ 11.3. خطاهای رایج مبتدیان
                                                                                                                  • ☰ 11.4. try و except
                                                                                                                    • ☰ 11.5. راهبردهای اشکال‌زدایی
                                                                                                                    • ☰ 12. فصل ۱۲: استفاده از کتابخانه‌های پایتون
                                                                                                                      • ☰ 12.1. کتابخانه چیست؟
                                                                                                                        • ☰ 12.2. وارد کردن ماژول‌ها
                                                                                                                          • ☰ 12.3. کتابخانه‌های استاندارد
                                                                                                                            • ☰ 12.3.1. math
                                                                                                                              • ☰ 12.3.2. random
                                                                                                                                • ☰ 12.3.3. datetime
                                                                                                                                • ☰ 12.4. نصب کتابخانه‌های خارجی با pip
                                                                                                                                • ☰ 13. فصل ۱۳: برنامه‌نویسی شی‌گرا (OOP)
                                                                                                                                  • ☰ 13.1. برنامه‌نویسی شی‌گرا چیست؟
                                                                                                                                    • ☰ 13.2. کلاس‌ها و اشیاء
                                                                                                                                      • ☰ 13.3. ویژگی‌ها و متدها
                                                                                                                                        • ☰ 13.4. متد `__init__`
                                                                                                                                          • ☰ 13.5. کپسوله‌سازی
                                                                                                                                            • ☰ 13.6. وراثت (مقدماتی)
                                                                                                                                              • ☰ 13.7. مثال‌های سادهٔ شی‌گرا
                                                                                                                                              • ☰ 14. فصل ۱۴: خودکارسازی با پایتون
                                                                                                                                                • ☰ 14.1. خودکارسازی چیست؟
                                                                                                                                                  • ☰ 14.2. خودکار کردن وظایف ساده
                                                                                                                                                    • ☰ 14.3. کار با فایل‌ها و پوشه‌ها
                                                                                                                                                      • ☰ 14.4. خودکارسازی پردازش متن
                                                                                                                                                        • ☰ 14.5. زمان‌بندی اجرای اسکریپت‌ها
                                                                                                                                                          • ☰ 14.6. مثال‌های کاربردی خودکارسازی
                                                                                                                                                          • ☰ 15. فصل ۱۵: توسعهٔ وب با پایتون
                                                                                                                                                            • ☰ 15.1. وب چگونه کار می‌کند؟ (نمای کلی)
                                                                                                                                                              • ☰ 15.2. آشنایی با Flask
                                                                                                                                                                • ☰ 15.3. ساخت یک وب‌سرور ساده
                                                                                                                                                                  • ☰ 15.4. مسیرها و قالب‌ها (Templates)
                                                                                                                                                                    • ☰ 15.5. پردازش ورودی کاربر (فرم‌ها)
                                                                                                                                                                      • ☰ 15.6. API های بسیار ساده
                                                                                                                                                                      • ☰ 16. فصل ۱۶: علم داده با پایتون
                                                                                                                                                                        • ☰ 16.1. علم داده چیست؟
                                                                                                                                                                          • ☰ 16.2. کار با داده‌ها
                                                                                                                                                                            • ☰ 16.3. آشنایی با NumPy
                                                                                                                                                                              • ☰ 16.4. آشنایی با pandas
                                                                                                                                                                                • ☰ 16.5. مصورسازی داده با matplotlib
                                                                                                                                                                                  • ☰ 16.6. مثال‌های سادهٔ تحلیل داده
                                                                                                                                                                                  • ☰ 17. فصل ۱۷: پروژه‌های کوچک
                                                                                                                                                                                    • ☰ 17.1. بازی حدس عدد
                                                                                                                                                                                      • ☰ 17.2. ماشین‌حساب ساده
                                                                                                                                                                                        • ☰ 17.3. فهرست کارها (To-Do List)
                                                                                                                                                                                          • ☰ 17.4. تولیدکنندهٔ رمز عبور
                                                                                                                                                                                            • ☰ 17.5. برنامهٔ آزمون (Quiz)
                                                                                                                                                                                              • ☰ 17.6. پروژهٔ کوچک وب یا داده
                                                                                                                                                                                              • ☰ 18. فصل ۱۸: گام‌های بعدی
                                                                                                                                                                                                • ☰ 18.1. چگونه پایتون را تمرین کنیم
                                                                                                                                                                                                  • ☰ 18.2. نوشتن کد تمیز و خوانا
                                                                                                                                                                                                    • ☰ 18.3. انتخاب یک حوزهٔ تخصصی
                                                                                                                                                                                                      • ☰ 18.3.1. توسعهٔ وب
                                                                                                                                                                                                        • ☰ 18.3.2. علم داده
                                                                                                                                                                                                          • ☰ 18.3.3. خودکارسازی
                                                                                                                                                                                                            • ☰ 18.3.4. توسعهٔ نرم‌افزار
                                                                                                                                                                                                            • ☰ 18.4. منابع یادگیری و انجمن‌ها
                                                                                                                                                                                                            • ☰ 19. پیوست
                                                                                                                                                                                                              • ☰ 19.1. برگهٔ تقلب دستور زبان پایتون
                                                                                                                                                                                                                • ☰ 19.2. خطاهای رایج و راه‌حل‌ها
                                                                                                                                                                                                                  • ☰ 19.3. واژه‌نامهٔ اصطلاحات