Kif jaħdmu l-parametri tal-funzjoni u l-argumenti standard?

Question

Accepted Answer

Il-funzjonijiet Python jisportaw argumenti **positional** u **keyword**, flimkien ma' **valuri default**. Il-fahm ta' kif huma kkombinati — u ħadd minn dawk il-**default-argument pitfall** — hija essenzjali.

## Argumenti positional, keyword, u default

```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
```

Il-parametri b'defaults huma ta' iktar ġenerali; tista' tgħaddi argumenti skond il-pożizzjoni jew skond l-isem (l-argumenti keyword jtgħaqqdu l-leggibilità u jippermettu lil inti li tilef parametri ta' iktar ġenerali aktar kmieni).

## Il-famous gotcha: mutable default argumenti

```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
```

Il-valuri default jiġu evalwati **darba** meta l-funzjoni tiġi definita, mhux kull sejħa. Valur default mutable (lista/dict) bħal dan jiġi shared bejn is-sejħat — ħamsa klassika. Il-fix:

```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
```

## Parametri keyword-only u positional-only

```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
    ...
```

L-markers `*` u `/` jippermettu lil inti tenforcjaw kif l-argumenti jitgħaddu — utli għal APIs ċari u stabbli.

## Għaliex hija importanti

L-fahm tal-handling tal-parametri hija fundamentali għall-kitba u l-sejħa tal-funzjonijiet Python b'mod korrett.

Id-defaults jagħmlu l-funzjonijiet flessibli, u l-argumenti keyword jagħmlu s-sejħat self-documenting.

B'mod kritiku, il-**mutable-default-argument trap** hija waħda mill-bugs Python l-aktar komuni u kkonfuzanti — li taf li l-defaults jiġu evalwati darba (għalhekk il-mutable defaults jibqgħu lejn is-sejħat) u l-fix tal-sentinel `None` jipprevjeni klassi sħiħ ta' errors sottili.

Id-data din hija l-fundament tal-disinjo ta' APIs tal-funzjoni ċari u prevedibili.