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

جلسه‌ی 14: پارامترها و آرگومان‌ها Parameters and Arguments

همه‌ی شکل‌های پارامتر در پایتون: موقعیتی، کلیدی، پیش‌فرض، *args، **kwargs، فقط‌کلیدی و باز کردن آرگومان‌ها هنگام فراخوانی.

در این جلسه یاد می‌گیری

درس

آرگومان‌ها را می‌توان به ترتیب (positional) یا با نام (keyword) فرستاد. آرگومان کلیدی فراخوانی را خواناتر می‌کند و ترتیب را بی‌اهمیت؛ ولی بعد از اولین آرگومان کلیدی دیگر نمی‌توان آرگومان موقعیتی داد.

def transfer(source, target, amount):
    return f"{amount} from {source} to {target}"

print(transfer("A", "B", 50))
print(transfer(amount=50, target="B", source="A"))

پارامتر با مقدار پیش‌فرض اختیاری می‌شود. دام مهم: مقدار پیش‌فرض یک بار هنگام تعریف تابع ساخته می‌شود؛ پس یک لیست یا دیکشنری پیش‌فرض بین همه‌ی فراخوانی‌ها مشترک است. الگوی درست، پیش‌فرض None است.

def add_tag(tag, tags=None):
    if tags is None:
        tags = []
    tags.append(tag)
    return tags

print(add_tag("a"), add_tag("b"))  # ['a'] ['b']

*args همه‌ی آرگومان‌های موقعیتیِ اضافه را در یک تاپل جمع می‌کند و **kwargs همه‌ی آرگومان‌های کلیدیِ اضافه را در یک دیکشنری. نام‌ها قراردادی‌اند؛ آنچه مهم است * و ** است.

def report(title, *values, **options):
    print(title, values, options)

report("cpu", 31, 47, unit="%", precise=True)
# cpu (31, 47) {'unit': '%', 'precise': True}

هر پارامتری که بعد از * (یا بعد از *args) بیاید فقط‌کلیدی (keyword-only) است و باید با نام فرستاده شود. این کار برای گزینه‌هایی مثل timeout جلوی اشتباه در ترتیب را می‌گیرد.

def connect(host, *, port=5432, timeout=10):
    return f"{host}:{port} timeout={timeout}"

print(connect("db", timeout=3))
# connect("db", 5433)  -> TypeError

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

def box(width, height, depth):
    return width * height * depth

dims = [2, 3, 4]
config = {"width": 1, "height": 5, "depth": 2}
print(box(*dims), box(**config))  # 24 10

ترتیب مجاز در تعریف: پارامترهای عادی، *args، پارامترهای فقط‌کلیدی، **kwargs. تابع‌هایی که ده‌ها پارامتر موقعیتی دارند معمولاً نشانه‌ی طراحی ضعیف‌اند؛ گزینه‌های اختیاری را کلیدی کن.

مثال‌های این جلسه

چالش‌ها

  1. Default Greeting (آسان)
  2. Variadic Total (آسان)
  3. Keyword Call (آسان)
  4. Mutable Default Fix (متوسط)
  5. Query String (متوسط)
  6. Keyword-Only Options (متوسط)
  7. Unpack Into Call (متوسط)
  8. Log Formatter (سخت)
  9. Merge Settings (سخت)
  10. Configurable Aggregate (سخت)
  11. HTML Tag Builder (سخت)
  12. Price Formatter (متوسط)

بیشتر بخوان

← جلسه‌ی 13: تعریف تابع و مقدار بازگشتی جلسه‌ی 15: حوزه‌ی دید و کلوژر →