Si funksionojnë parametrat e funksionit dhe argumentet e parazgjedhur?

Question

Accepted Answer

Funksionet Python mbështesin argumentet **pozicionale** dhe **të emërtuar**, plus **vlerat e parazgjedhura**. Kuptimi se si kombinohen ato — dhe një gotçë e famshme e argumenteve të parazgjedhuar — është thelbësor.

## Argumentet pozicionale, të emërtuar dhe të parazgjedhur

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

Parametrat me parazgjedhje janë opcionale; mund të kaloni argumente sipas pozicionit ose sipas emri (argumentet me emër përmiresojnë lexueshmërinë dhe ju lejojnë të kaloni mbi parametrat opcionale më të hershëm).

## Gotçja e famshme: argumentet e parazgjedhura të ndryshueshmëm

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

Vlerat e parazgjedhura vlerësohen **një herë** kur përcaktohet funksioni, jo në çdo thirrje. Një parazgjedhje e ndryshueshmë (listë/fjalor) ndahet prandaj midis thirrjeve — një gabim klasik. Zgjidhja:

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

## Parametrat vetëm për emërim dhe vetëm pozicionale

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

Markat `*` dhe `/` ju lejojnë të zbatoni se si kalojnë argumentet — e dobishme për API-t të qarta dhe të qëndrueshme.

## Pse ka rëndësi

Kuptimi i trajtimit të parametrave është themelor për të shkruar dhe thirrur funksionet Python në mënyrë korrekte.

Parazgjedhjet e bëjnë funksionet fleksibël, dhe argumentet e emërtuar e bëjnë vetë-dokumentimin e thirrjeve.

Në të vërtetë, **gotça e argumenteve të parazgjedhura të ndryshueshmë** është një nga gabimet më të zakonshme dhe më çuditëse në Python — dijes se vlerat e parazgjedhura vlerësohen një herë (kështu që parazgjedhjet e ndryshueshmë përdoren në të gjitha thirrjet) dhe zgjidhja e `None`-sentinel parandalon një klasë të tërë gabimesh delikate.

Kjo njohuri supozon dizajnimin e API-ve të funksioneve të pastra dhe të parashikueshme.