База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

Вариадични параметри `*args` и `**kwargs`

В Python 3.12 `*args` събира допълнителните позиционни аргументи в кортеж, а `**kwargs` събира несъпоставените именувани аргументи в речник. При извикване същите знаци разопаковат аргументи.

Версия: Python 3.12

Синтаксис

def f(first, *args, flag=False, **kwargs):
    ...

В дефиницията на функция *args събира в кортеж (tuple) позиционните аргументи, които не са присвоени на предходни параметри, като запазва реда им. **kwargs събира в нов речник (dict) именуваните аргументи, които не съответстват на деклариран параметър, способен да ги приеме. Ако няма какво да се събере, се получават съответно () и {}. Имената args и kwargs са по уговорка: *items и **opts действат по същия начин.

Параметър като flag след *args може да се подаде само по име, например flag=True. Самостоятелната звездичка * също въвежда параметри, които се подават само по име, но не събира аргументи. Ако присъстват и двата вариадични параметъра, *args стои преди **kwargs, а **kwargs е последен в списъка с параметри.

При извикване посоката е обратна: f(*items) разопакова итерируем обект в отделни позиционни аргументи, а f(**opts) разопакова елементите на съпоставяне с ключове от тип str в именувани аргументи. Подаването на две стойности за един и същ параметър или на именуван аргумент без съответстващ параметър, когато няма **kwargs, предизвиква TypeError. В тези контексти * и ** не означават умножение или степенуване.

Примери

def compute_rows(*items, label="rows"):
    return label, items


def build_config(**opts):
    return opts


print(compute_rows(*[10, 20], label="scores"))
print(compute_rows())
print(build_config(**{"theme": "dark"}))
print(build_config())

Резултат

('scores', (10, 20))
('rows', ())
{'theme': 'dark'}
{}

Списъкът подава два позиционни аргумента на `compute_rows`, а `label` се подава отделно по име. `build_config` събира `theme` в `opts`. Извикванията без аргументи показват празния кортеж, празния речник и стойността по подразбиране на `label`.

Свързани уроци

  • Python · Урок 18 · Средно · Версия: 3

Източници