CKTIS / Python
Вариадични позиционни параметри: `*args`
В дефиниция на функция `*args` събира излишните позиционни аргументи в кортеж. При извикване `*` разопакова итерируем обект до позиционни аргументи.
Версия: Python 3.12
Синтаксис
def f(required, *args, option=False):
...В Python 3.12 в дефиницията def f(required, *args, option=False): параметърът *args събира позиционните аргументи, които не са свързани с предходните параметри, в реда на подаването им. В тялото на функцията args е кортеж, или (), ако няма излишни аргументи.
Името args е общоприето, но не е задължително; префиксът * показва, че параметърът събира позиционни аргументи. Понеже option е след *args, стойност за него може да се подаде само по име, например с option=True. Самостоятелната звездичка * също въвежда параметри, които се задават само по име, но не събира позиционни аргументи.
В дефиницията една звездичка събира позиционни аргументи, а при извикване като func(*args, **kwargs) разопакова итерируем обект до позиционни аргументи. За препращане на именувани аргументи обвиващата функция използва отделен механизъм: в дефиницията **kwargs събира несъпоставените именувани аргументи в речник, а при извикването ** разопакова обект за съпоставяне с ключове от тип низ до именувани аргументи. Сигнатурата на целевата функция остава в сила: липсващ задължителен аргумент или две стойности за един и същ параметър водят до TypeError.
Обвиваща функция за одит може да преброи аргументите, да ги препрати без промени и да върне резултата на целевата функция. functools.wraps запазва метаданни като името на оригиналната функция. Не записвай необработените стойности на аргументите в реални одитни дневници: те може да съдържат пароли или други чувствителни данни.
Примери
from functools import wraps
def audit(func):
@wraps(func)
def wrapper(*args, **kwargs):
print(f"audit: positional={len(args)}, keyword={len(kwargs)}")
return func(*args, **kwargs)
return wrapper
@audit
def total(base=0, *increments, scale=1):
return (base + sum(increments)) * scale
print(total(10, 2, 3, scale=2))
print(total())Резултат
audit: positional=3, keyword=1 30 audit: positional=0, keyword=0 0
При първото извикване обвиващата функция преброява три позиционни и един именуван аргумент. След препращането `total` свързва `10` с `base`, `(2, 3)` с `increments` и `2` със `scale` и връща `30`. Второто извикване показва двете празни колекции (`()` и `{}`); стойностите по подразбиране дават `0`.
Свързани уроци
- Python · Урок 10 · Напреднало · Версия: 5