كيف تعمل معاملات الدوال والمعاملات الافتراضية؟

Question

Accepted Answer

تدعم دوال Python المعاملات **الموضعية** و**الكلمات المفتاحية**، بالإضافة إلى **القيم الافتراضية**. فهم كيفية دمجها - وفخ واحد شهير في المعاملات الافتراضية - أمر ضروري.

## المعاملات الموضعية والكلمات المفتاحية والمعاملات الافتراضية

```python
def greet(name, greeting="Hello", punctuation="!"):
    return f"{greeting}, {name}{punctuation}"

greet("Ann")                          # positional → "Hello, Ann!"
greet("Ann", "Hi")                    # "Hi, Ann!"
greet("Ann", punctuation=".")          # keyword arg → "Hello, Ann."
greet(name="Ann", greeting="Hey")      # all by keyword
```

المعاملات ذات القيم الافتراضية اختيارية؛ يمكنك تمرير المعاملات حسب الموضع أو بالاسم (معاملات الكلمات المفتاحية تحسن سهولة القراءة وتسمح لك بتخطي المعاملات الاختيارية الأولى).

## الفخ الشهير: المعاملات الافتراضية القابلة للتغيير

```python
# ❌ DANGER — the default list is created ONCE and SHARED across all calls
def add_item(item, items=[]):
    items.append(item)
    return items

add_item("a")   # ["a"]
add_item("b")   # ["a", "b"]  ← surprise! the SAME list persisted
```

يتم تقييم القيم الافتراضية **مرة واحدة** عند تعريف الدالة، وليس في كل استدعاء. القيمة الافتراضية القابلة للتغيير (list/dict) تُشارك بين الاستدعاءات - وهي حالة خطأ كلاسيكية. الحل:

```python
# ✅ use None as the default and create a fresh object inside
def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items
```

## معاملات كلمات مفتاحية فقط ومعاملات موضعية فقط

```python
def f(a, b, *, key):       # `*` → `key` MUST be passed by keyword
    ...
f(1, 2, key=3)             # ✅   f(1, 2, 3) ❌

def g(a, b, /, c):         # `/` → a, b MUST be positional
    ...
```

علامات `*` و `/` تسمح لك بفرض كيفية تمرير المعاملات - مفيدة لـ APIs واضحة وثابتة.

## لماذا يهم

فهم معالجة المعاملات أمر أساسي لكتابة واستدعاء دوال Python بشكل صحيح.

القيم الافتراضية تجعل الدوال مرنة، ومعاملات الكلمات المفتاحية تجعل الاستدعاءات توضيحية ذاتياً.

الأهم من ذلك، **فخ المعاملات الافتراضية القابلة للتغيير** هو أحد أخطاء Python الأكثر شيوعاً وإرباكاً - معرفة أن القيم الافتراضية يتم تقييمها مرة واحدة (لذلك تستمر القيم الافتراضية القابلة للتغيير عبر الاستدعاءات) وإصلاح `None`-sentinel يمنع فئة كاملة من الأخطاء الدقيقة.

هذه المعرفة تشكل أساس تصميم واجهات برمجية نظيفة وقابلة للتنبؤ بها.