* الحجج و ** kwargs

في بعض الأحيان تريد دالة تقبل عددًا متغيرًا من الحجج. تمنحك Python أداتين: *args (تجمع الوسائط الموضعية في صف) و **kwargs (يجمع وسيطات الكلمات الرئيسية في الإملاء).

*args: الوسائط الموضعية المتغيرة

def somma_tutto(*nums):
    totale = 0
    for n in nums:
        totale += n
    return totale

somma_tutto(1, 2, 3)         # 6
somma_tutto(1, 2, 3, 4, 5)   # 15
somma_tutto()                # 0

داخل الدالة، nums عبارة عن tuple مع جميع القيم التي تم تمريرها. ال الاسم مجرد اصطلاح: *args هو الأكثر شيوعًا، ولكن *nums أو *valori صالحة تمامًا.

**kwargs: وسائط الكلمات الرئيسية المتغيرة

def crea_config(**opzioni):
    return opzioni

crea_config(debug=True, port=8080)
# {'debug': True, 'port': 8080}

داخل الدالة، opzioni عبارة عن dict مع {param_name: value}.

الجمع بين كل شيء

الترتيب الثابت هو: **المعلمات العادية، *args، المعلمات الافتراضية، **kwargs**.

def f(primo, *args, opzione="x", **kwargs):
    print(primo, args, opzione, kwargs)

f(1, 2, 3, opzione="y", extra=10)
# 1 (2, 3) y {'extra': 10}

تفريغ المكالمة: * و **

يعمل نفس العامل في الاتجاه المعاكس: "لتفجير" قائمة/مجموعة في الوسائط الموضعية أو الإملاء في وسائط الكلمات الرئيسية.

def punto(x, y, z):
    return (x, y, z)

coords = [1, 2, 3]
punto(*coords)        # punto(1, 2, 3)  →  (1, 2, 3)

opts = {"x": 1, "y": 2, "z": 3}
punto(**opts)         # punto(x=1, y=2, z=3)

نمط الغلاف

def log_chiamata(fn, *args, **kwargs):
    print(f"chiamo {fn.__name__} con {args=} {kwargs=}")
    return fn(*args, **kwargs)

log_chiamata(max, 3, 1, 2)             # calls max(3, 1, 2)
log_chiamata(sorted, [3, 1, 2], reverse=True)

ترتيب المعلمات في التوقيعات الوظيفية

عند تحديد دالة تقبل أنواعًا متعددة من الوسائط، يجب عليك الالتزام بترتيب صارم في التوقيع:

1. المعلمات الموضعية القياسية.
2. المتغيرات الموضعية *args.
3. معلمات الكلمات الرئيسية ذات القيم الافتراضية.
4. متغيرات الكلمات الرئيسية **kwargs.

جربه

تمرين المراجعة

التحدي الإضافي