Kaip veikia funkcijos parametrai ir numatytieji argumentai?

Question

Accepted Answer

Python funkcijos palaiko **pozicinius** ir **raktažodinius** argumentus, taip pat **numatytąsias reikšmes**. Supratimas, kaip jie yra sujungti — ir viena garsėjanti numatytųjų argumentų spąstų — yra esminė.

## Pozicininiai, raktažodiniai ir numatytieji argumentai

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

Parametrai su numatytaisiais reikšmėmis yra pasirinkti; argumentus galite perduoti pagal poziciją arba pagal pavadinimą (raktažodiniai argumentai pagerina skaitomumą ir leidžia praleisti ankstesnius pasirinktinius parametrus).

## Garsėjinti spąstai: kintamos numatytosios reikšmės

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

Numatytosios reikšmės yra įvertinamos **vieną kartą** apibrėžiant funkciją, o ne kiekvieno iškvietime. Kintama numatytoji reikšmė (sąrašas/dict) yra bendrinama tarp iškvietimų — klasikine klaida. Pataisymas:

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

## Tik raktažodiniai ir tik pozicininiai parametrai

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

`*` ir `/` žymenys leidžia jums nustatyti, kaip argumentai perduodami — naudingi aiščiems, stabilūs API.

## Kodėl tai svarbu

Parametrų tvarkymo supratimas yra esminis norint teisingai rašyti ir iškviesti Python funkcijas.

Numatytosios reikšmės padaro funkcijas lanksčias, o raktažodiniai argumentai daro iškvietimus savidokumentavimo.

Krucialiai, **kintamos numatytosios reikšmės spąstai** yra viena iš dažniausių ir painiausių Python klaidų — žinojimas, kad numatytosios reikšmės yra vertinamos vieną kartą (todėl kintamos numatytosios reikšmės išlieka tarp iškvietimų) ir `None`-sentinel pataisymas neleidžia subtiliųjų klaidų klasei.

Šis žinojimas yra grindimas tyru, nuspėjamiųjų funkcijos API projektavimu.