Kas yra *args ir **kwargs?

Question

Accepted Answer

`*args` ir `**kwargs` leidžia funkcijai priimti **kintamą skaičių** argumentų. `*args` renka papildomus **pozicinimus** argumentus į tuple; `**kwargs` renka papildomus **raktinį žodį** argumentus į dict. (Vardai yra konvencija — `*` ir `**` yra svarbūs.)

## *args — kintami poziciniai argumentai

```python
def total(*args):           # collects all positional args into a tuple
    print(args)             # e.g. (1, 2, 3)
    return sum(args)

total(1, 2, 3)              # 6
total(1, 2, 3, 4, 5)        # 15 — any number of args
```

## **kwargs — kintami raktinį žodį argumentai

```python
def configure(**kwargs):    # collects keyword args into a dict
    print(kwargs)           # e.g. {"host": "localhost", "port": 8080}
    for key, value in kwargs.items():
        print(f"{key} = {value}")

configure(host="localhost", port=8080, debug=True)
```

## Jų sujungimas (su įprastais parametrais)

```python
def func(a, b, *args, **kwargs):
    # a, b → required positional
    # args → extra positional (tuple)
    # kwargs → extra keyword (dict)
    ...

func(1, 2, 3, 4, x=5, y=6)
# a=1, b=2, args=(3, 4), kwargs={"x": 5, "y": 6}
```

Reikalinga tvarka: įprasti params, tada `*args`, tada `**kwargs`.

## Išpaketavimas — atvirkštinis kryptis

```python
# `*` and `**` also UNPACK collections INTO arguments at the call site
numbers = [1, 2, 3]
total(*numbers)              # same as total(1, 2, 3)

settings = {"host": "x", "port": 80}
configure(**settings)         # same as configure(host="x", port=80)
```

Ta pati sintaksė išpakuoja list/dict į pozicinį/raktinį žodį argumentus — patogu argumentams persiųsti.

## Dažniausias tikrasis panaudojimas: argumentų persiuntimas (dekoratoriai, apvalkalai)

```python
def wrapper(*args, **kwargs):
    # accept ANY arguments and pass them through unchanged
    return original_func(*args, **kwargs)
```

Šis pralaidumo šablonas yra tai, kaip dekoratoriai ir apvalkalo funkcijos tvarko bet kurio ženklo signaturą.

## Kodėl tai svarbu

`*args`/`**kwargs` leidžia lanksčias funkcijų signatūras, kurios gali priimti bet kokį skaičių argumentų — esminis norint rašyti bendro tikslo programas, apvalkalus ir ypač **dekoratorius** (kurie turi apvesti nežinomų signaturų funkcijas per `*args, **kwargs`).

Išpakavimo kryptis (`*list`, `**dict`) yra vienodai naudinga argumentams persiųsti arba išskleisti.

Supratimas apie rinkimą ir išpakavimą yra raktas į naudojamų, žinomo Python kodo rašymą ir į daug bibliotekų API ir dekoratorių, kurie remiasi šiomis savybėmis, skaitymą.