Что ** (двойная звезда / звездочка) и * (звездочка / звездочка) делают для параметров?
В следующих определениях метода, что делает *
а также **
делать для param2
?
def foo(param1, *param2):
def bar(param1, **param2):
29 ответов
*args
а также **kwargs
это общая идиома для разрешения произвольного числа аргументов функций, как описано в разделе, посвященном определению функций в документации по Python.
*args
даст вам все параметры функции в виде кортежа:
In [1]: def foo(*args):
...: for a in args:
...: print a
...:
...:
In [2]: foo(1)
1
In [4]: foo(1,2,3)
1
2
3
**kwargs
предоставит вам все ключевые аргументы, за исключением тех, которые соответствуют формальному параметру в качестве словаря.
In [5]: def bar(**kwargs):
...: for a in kwargs:
...: print a, kwargs[a]
...:
...:
In [6]: bar(name='one', age=27)
age 27
name one
Обе идиомы могут быть смешаны с обычными аргументами, чтобы позволить набор фиксированных и некоторых переменных аргументов:
def foo(kind, *args, **kwargs):
pass
Другое использование *l
идиома - распаковывать списки аргументов при вызове функции.
In [9]: def foo(bar, lee):
...: print bar, lee
...:
...:
In [10]: l = [1,2]
In [11]: foo(*l)
1 2
В Python 3 можно использовать *l
в левой части присвоения ( Extended Iterable Unpacking), хотя в этом контексте он дает список вместо кортежа:
first, *rest = [1,2,3,4]
first, *l, last = [1,2,3,4]
Также Python 3 добавляет новую семантику (см. PEP 3102):
def func(arg1, arg2, arg3, *, kwarg1, kwarg2):
pass
Такая функция принимает только 3 позиционных аргумента, а все после *
могут быть переданы только в качестве аргументов ключевых слов.
Стоит также отметить, что вы можете использовать *
а также **
при вызове функций. Это ярлык, который позволяет передавать несколько аргументов функции напрямую, используя список / кортеж или словарь. Например, если у вас есть следующая функция:
def foo(x,y,z):
print("x=" + str(x))
print("y=" + str(y))
print("z=" + str(z))
Вы можете делать такие вещи, как:
>>> mylist = [1,2,3]
>>> foo(*mylist)
x=1
y=2
z=3
>>> mydict = {'x':1,'y':2,'z':3}
>>> foo(**mydict)
x=1
y=2
z=3
>>> mytuple = (1, 2, 3)
>>> foo(*mytuple)
x=1
y=2
z=3
Примечание: ключи в mydict
должны быть названы точно так же, как параметры функции foo
, В противном случае это бросит TypeError
:
>>> mydict = {'x':1,'y':2,'z':3,'badnews':9}
>>> foo(**mydict)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: foo() got an unexpected keyword argument 'badnews'
Один * означает, что может быть любое количество дополнительных позиционных аргументов. foo()
может быть вызван как foo(1,2,3,4,5)
, В теле foo() param2 - это последовательность, содержащая 2-5.
Двойной ** означает, что может быть любое количество дополнительных именованных параметров. bar()
может быть вызван как bar(1, a=2, b=3)
, В теле bar() param2 находится словарь, содержащий {'a':2, 'b':3 }
Со следующим кодом:
def foo(param1, *param2):
print(param1)
print(param2)
def bar(param1, **param2):
print(param1)
print(param2)
foo(1,2,3,4,5)
bar(1,a=2,b=3)
выход
1
(2, 3, 4, 5)
1
{'a': 2, 'b': 3}
Что значит
**
(двойная звезда) и*
(звезда) сделать для параметров
Они позволяют определенным функциям принимать и пользователям передавать любое количество аргументов, позиционные (*
) и ключевое слово (**
).
Определение функций
*args
допускает любое количество необязательных позиционных аргументов (параметров), которые будут назначены кортежу с именем args
,
**kwargs
допускает любое количество необязательных аргументов ключевого слова (параметров), которые будут в диктовке с именем kwargs
,
Вы можете (и должны) выбрать любое подходящее имя, но если намерение состоит в том, чтобы аргументы были неспецифической семантики, args
а также kwargs
являются стандартными именами.
Расширение, передавая любое количество аргументов
Вы также можете использовать *args
а также **kwargs
передать параметры из списков (или любых повторяемых) и dicts (или любого отображения), соответственно.
Функция получения параметров не должна знать, что они расширяются.
Например, xrange Python 2 явно не ожидает *args
, но так как он принимает 3 целых числа в качестве аргументов:
>>> x = xrange(3) # create our *args - an iterable of 3 integers
>>> xrange(*x) # expand here
xrange(0, 2, 2)
В качестве другого примера, мы можем использовать расширение dict в str.format
:
>>> foo = 'FOO'
>>> bar = 'BAR'
>>> 'this is foo, {foo} and bar, {bar}'.format(**locals())
'this is foo, FOO and bar, BAR'
Новое в Python 3: определение функций с аргументами только из ключевых слов
Вы можете иметь только ключевые слова аргументы после *args
- например, здесь, kwarg2
должен быть задан в качестве ключевого аргумента, а не позиционно:
def foo(arg, kwarg=None, *args, kwarg2=None, **kwargs):
return arg, kwarg, args, kwarg2, kwargs
Использование:
>>> foo(1,2,3,4,5,kwarg2='kwarg2', bar='bar', baz='baz')
(1, 2, (3, 4, 5), 'kwarg2', {'bar': 'bar', 'baz': 'baz'})
Также, *
может использоваться сам по себе, чтобы указать, что за ключевым словом следуют только аргументы, без учета неограниченных позиционных аргументов.
def foo(arg, kwarg=None, *, kwarg2=None, **kwargs):
return arg, kwarg, kwarg2, kwargs
Вот, kwarg2
снова должен быть явно названным аргументом ключевого слова:
>>> foo(1,2,kwarg2='kwarg2', foo='foo', bar='bar')
(1, 2, 'kwarg2', {'foo': 'foo', 'bar': 'bar'})
И мы больше не можем принимать неограниченные позиционные аргументы, потому что у нас нет *args*
:
>>> foo(1,2,3,4,5, kwarg2='kwarg2', foo='foo', bar='bar')
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: foo() takes from 1 to 2 positional arguments
but 5 positional arguments (and 1 keyword-only argument) were given
Опять же, проще говоря, здесь мы требуем kwarg
быть заданным по имени, а не позиционно:
def bar(*, kwarg=None):
return kwarg
В этом примере мы видим, что если мы пытаемся пройти kwarg
позиционно получаем ошибку:
>>> bar('kwarg')
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: bar() takes 0 positional arguments but 1 was given
Мы должны явно передать kwarg
параметр в качестве ключевого аргумента.
>>> bar(kwarg='kwarg')
'kwarg'
Python 2-совместимые демки
*args
(как правило, говорят "Звездные Арги") и **kwargs
(Звезды могут подразумеваться, говоря "kwargs", но быть явным с "двойными звездами kwargs") - общие идиомы Python для использования *
а также **
нотации. Эти конкретные имена переменных не требуются (например, вы можете использовать *foos
а также **bars
), но отход от соглашения, вероятно, рассердит ваших коллег по Python.
Мы обычно используем их, когда не знаем, что получит наша функция или сколько аргументов мы можем передать, а иногда даже когда именуем каждую переменную по отдельности, получится очень грязно и избыточно (но это тот случай, когда обычно явно лучше, чем неявное).
Пример 1
Следующая функция описывает, как их можно использовать, и демонстрирует поведение. Обратите внимание на названный b
Аргумент будет использоваться вторым позиционным аргументом перед:
def foo(a, b=10, *args, **kwargs):
'''
this function takes required argument a, not required keyword argument b
and any number of unknown positional arguments and keyword arguments after
'''
print('a is a required argument, and its value is {0}'.format(a))
print('b not required, its default value is 10, actual value: {0}'.format(b))
# we can inspect the unknown arguments we were passed:
# - args:
print('args is of type {0} and length {1}'.format(type(args), len(args)))
for arg in args:
print('unknown arg: {0}'.format(arg))
# - kwargs:
print('kwargs is of type {0} and length {1}'.format(type(kwargs),
len(kwargs)))
for kw, arg in kwargs.items():
print('unknown kwarg - kw: {0}, arg: {1}'.format(kw, arg))
# But we don't have to know anything about them
# to pass them to other functions.
print('Args or kwargs can be passed without knowing what they are.')
# max can take two or more positional args: max(a, b, c...)
print('e.g. max(a, b, *args) \n{0}'.format(
max(a, b, *args)))
kweg = 'dict({0})'.format( # named args same as unknown kwargs
', '.join('{k}={v}'.format(k=k, v=v)
for k, v in sorted(kwargs.items())))
print('e.g. dict(**kwargs) (same as {kweg}) returns: \n{0}'.format(
dict(**kwargs), kweg=kweg))
Мы можем проверить онлайн справку для подписи функции, с help(foo)
, который говорит нам
foo(a, b=10, *args, **kwargs)
Давайте назовем эту функцию с foo(1, 2, 3, 4, e=5, f=6, g=7)
который печатает:
a is a required argument, and its value is 1
b not required, its default value is 10, actual value: 2
args is of type <type 'tuple'> and length 2
unknown arg: 3
unknown arg: 4
kwargs is of type <type 'dict'> and length 3
unknown kwarg - kw: e, arg: 5
unknown kwarg - kw: g, arg: 7
unknown kwarg - kw: f, arg: 6
Args or kwargs can be passed without knowing what they are.
e.g. max(a, b, *args)
4
e.g. dict(**kwargs) (same as dict(e=5, f=6, g=7)) returns:
{'e': 5, 'g': 7, 'f': 6}
Пример 2
Мы также можем вызвать его с помощью другой функции, в которую мы просто предоставляем a
:
def bar(a):
b, c, d, e, f = 2, 3, 4, 5, 6
# dumping every local variable into foo as a keyword argument
# by expanding the locals dict:
foo(**locals())
bar(100)
печатает:
a is a required argument, and its value is 100
b not required, its default value is 10, actual value: 2
args is of type <type 'tuple'> and length 0
kwargs is of type <type 'dict'> and length 4
unknown kwarg - kw: c, arg: 3
unknown kwarg - kw: e, arg: 5
unknown kwarg - kw: d, arg: 4
unknown kwarg - kw: f, arg: 6
Args or kwargs can be passed without knowing what they are.
e.g. max(a, b, *args)
100
e.g. dict(**kwargs) (same as dict(c=3, d=4, e=5, f=6)) returns:
{'c': 3, 'e': 5, 'd': 4, 'f': 6}
Пример 3: практическое использование в декораторах
Хорошо, возможно, мы еще не увидели утилиту. Итак, представьте, что у вас есть несколько функций с избыточным кодом до и / или после дифференцирующего кода. Следующие именованные функции являются просто псевдокодом для иллюстративных целей.
def foo(a, b, c, d=0, e=100):
# imagine this is much more code than a simple function call
preprocess()
differentiating_process_foo(a,b,c,d,e)
# imagine this is much more code than a simple function call
postprocess()
def bar(a, b, c=None, d=0, e=100, f=None):
preprocess()
differentiating_process_bar(a,b,c,d,e,f)
postprocess()
def baz(a, b, c, d, e, f):
... and so on
Мы могли бы справиться с этим по-другому, но мы, конечно, можем извлечь избыточность с помощью декоратора, и поэтому наш пример ниже демонстрирует, как *args
а также **kwargs
может быть очень полезным:
def decorator(function):
'''function to wrap other functions with a pre- and postprocess'''
@functools.wraps(function) # applies module, name, and docstring to wrapper
def wrapper(*args, **kwargs):
# again, imagine this is complicated, but we only write it once!
preprocess()
function(*args, **kwargs)
postprocess()
return wrapper
И теперь каждая упакованная функция может быть написана гораздо более кратко, поскольку мы учли избыточность:
@decorator
def foo(a, b, c, d=0, e=100):
differentiating_process_foo(a,b,c,d,e)
@decorator
def bar(a, b, c=None, d=0, e=100, f=None):
differentiating_process_bar(a,b,c,d,e,f)
@decorator
def baz(a, b, c=None, d=0, e=100, f=None, g=None):
differentiating_process_baz(a,b,c,d,e,f, g)
@decorator
def quux(a, b, c=None, d=0, e=100, f=None, g=None, h=None):
differentiating_process_quux(a,b,c,d,e,f,g,h)
И с учетом нашего кода, который *args
а также **kwargs
Это позволяет нам сокращать количество строк кода, улучшать удобочитаемость и удобство обслуживания, а также иметь исключительно канонические места для логики в нашей программе. Если нам нужно изменить какую-либо часть этой структуры, у нас есть одно место, где можно вносить каждое изменение.
Давайте сначала разберемся, что такое позиционные аргументы и ключевые аргументы. Ниже приведен пример определения функции с позиционными аргументами.
def test(a,b,c):
print(a)
print(b)
print(c)
test(1,2,3)
#output:
1
2
3
Так что это определение функции с позиционными аргументами. Вы также можете вызвать его с помощью аргументов с ключевым словом / именованным:
def test(a,b,c):
print(a)
print(b)
print(c)
test(a=1,b=2,c=3)
#output:
1
2
3
Теперь давайте изучим пример определения функции с ключевыми словами:
def test(a=0,b=0,c=0):
print(a)
print(b)
print(c)
print('-------------------------')
test(a=1,b=2,c=3)
#output :
1
2
3
-------------------------
Вы также можете вызвать эту функцию с позиционными аргументами:
def test(a=0,b=0,c=0):
print(a)
print(b)
print(c)
print('-------------------------')
test(1,2,3)
# output :
1
2
3
---------------------------------
Итак, теперь мы знаем определения функций как с позиционными, так и с ключевыми словами.
Теперь давайте изучим оператор '*' и оператор **.
Обратите внимание, что эти операторы могут быть использованы в 2 областях:
а) вызов функции
б) определение функции
Использование оператора '*' и оператора ** в вызове функции.
Давайте перейдем непосредственно к примеру и обсудим его.
def sum(a,b): #receive args from function calls as sum(1,2) or sum(a=1,b=2)
print(a+b)
my_tuple = (1,2)
my_list = [1,2]
my_dict = {'a':1,'b':2}
# Let us unpack data structure of list or tuple or dict into arguments with help of '*' operator
sum(*my_tuple) # becomes same as sum(1,2) after unpacking my_tuple with '*'
sum(*my_list) # becomes same as sum(1,2) after unpacking my_list with '*'
sum(**my_dict) # becomes same as sum(a=1,b=2) after unpacking by '**'
# output is 3 in all three calls to sum function.
Так что помни
когда оператор "*" или "**" используется в вызове функции -
Оператор '*' распаковывает структуру данных, такую как список или кортеж, в аргументы, необходимые для определения функции.
Оператор '**' распаковывает словарь в аргументы, необходимые для определения функции.
Теперь давайте изучим использование оператора '*' в определении функции. Пример:
def sum(*args): #pack the received positional args into data structure of tuple. after applying '*' - def sum((1,2,3,4))
sum = 0
for a in args:
sum+=a
print(sum)
sum(1,2,3,4) #positional args sent to function sum
#output:
10
В определении функции оператор '*' упаковывает полученные аргументы в кортеж.
Теперь давайте посмотрим на пример **, используемый в определении функции:
def sum(**args): #pack keyword args into datastructure of dict after applying '**' - def sum({a:1,b:2,c:3,d:4})
sum=0
for k,v in args.items():
sum+=v
print(sum)
sum(a=1,b=2,c=3,d=4) #positional args sent to function sum
В определении функции Оператор '**' упаковывает полученные аргументы в словарь.
Итак, помните:
При вызове функции '*' распаковывает структуру данных кортежа или списка в позиционные или ключевые аргументы, которые должны быть получены определением функции.
При вызове функции "**" распаковывает структуру данных словаря в позиционные или ключевые аргументы, которые должны быть получены определением функции.
В определении функции '*' упаковывает позиционные аргументы в кортеж.
В определении функции "**" упаковывает аргументы ключевых слов в словарь.
В то время как в Python 3 было расширено использование операторов star / splat, мне нравится следующая таблица, так как она касается использования этих операторов с функциями. Оператор (ы) splat может использоваться как в конструкции функции, так и в вызове функции:
In function *construction* In function *call*
=======================================================================
| def f(*args): | def f(a, b):
*args | for arg in args: | return a + b
| print(arg) | args = (1, 2)
| f(1, 2) | f(*args)
----------|--------------------------------|---------------------------
| def f(a, b): | def f(a, b):
**kwargs | return a + b | return a + b
| def g(**kwargs): | kwargs = dict(a=1, b=2)
| return f(**kwargs) | f(**kwargs)
| g(a=1, b=2) |
-----------------------------------------------------------------------
Это на самом деле просто суммирует ответ Лорин Хохштайн, но я считаю его полезным.
TL;DR
Ниже приведены 6 различных вариантов использования *
а также **
в программировании на Python:
- Чтобы принять любое количество позиционных аргументов, используя
*args
:def foo(*args): pass
, Вотfoo
принимает любое количество позиционных аргументов, т.е. допустимы следующие вызовыfoo(1)
,foo(1, 'bar')
- Чтобы принять любое количество аргументов ключевого слова, используя
**kwargs
:def foo(**kwargs): pass
, здесь 'foo' принимает любое количество аргументов ключевого слова, т.е. допустимы следующие вызовыfoo(name='Tom')
,foo(name='Tom', age=33)
- Чтобы принять любое количество позиционных и ключевых аргументов, используя
*args, **kwargs
:def foo(*args, **kwargs): pass
, Вотfoo
принимает любое количество позиционных и ключевых аргументов, т. е. допустимы следующие вызовыfoo(1,name='Tom')
,foo(1, 'bar', name='Tom', age=33)
- Чтобы применить аргументы только по ключевым словам, используя
*
:def foo(pos1, pos2, *, kwarg1): pass
, Вот*
означает, что foo принимает аргументы ключевого слова только после pos2, следовательноfoo(1, 2, 3)
вызывает TypeError, ноfoo(1, 2, kwarg1=3)
в порядке. - Чтобы больше не интересоваться позиционными аргументами, используйте
*_
(Примечание: это только соглашение):def foo(bar, baz, *_): pass
означает (по соглашению)foo
только используетbar
а такжеbaz
аргументы в его работе и будут игнорировать другие. - Чтобы не проявлять дальнейшего интереса к дополнительным аргументам ключевых слов, используя
\**_
(Примечание: это только соглашение):def foo(bar, baz, **_): pass
означает (по соглашению)foo
только используетbar
а такжеbaz
аргументы в его работе и будут игнорировать другие.
БОНУС: Начиная с Python 3.8 и далее, можно использовать/
в определении функции для принудительного применения только позиционных параметров. В следующем примере параметры a и b являются только позиционными, в то время как c или d могут быть позиционными или ключевыми, а e или f должны быть ключевыми словами:
def f(a, b, /, c, d, *, e, f):
pass
*
а также **
имеют специальное использование в списке аргументов функции. *
подразумевает, что аргумент является списком и **
подразумевает, что аргумент является словарем. Это позволяет функциям принимать произвольное количество аргументов
Для тех из вас, кто учится на примерах!
- Цель
*
чтобы дать вам возможность определить функцию, которая может принимать произвольное количество аргументов, представленных в виде списка (например,f(*myList)
). - Цель
**
чтобы дать вам возможность кормить аргументы функции, предоставляя словарь (например,f(**{'x' : 1, 'y' : 2})
).
Покажем это, определив функцию, которая принимает две нормальные переменные x
, y
и может принять больше аргументов как myArgs
и может принять еще больше аргументов в качестве myKW
, Позже мы покажем, как кормить y
с помощью myArgDict
,
def f(x, y, *myArgs, **myKW):
print("# x = {}".format(x))
print("# y = {}".format(y))
print("# myArgs = {}".format(myArgs))
print("# myKW = {}".format(myKW))
print("# ----------------------------------------------------------------------")
# Define a list for demonstration purposes
myList = ["Left", "Right", "Up", "Down"]
# Define a dictionary for demonstration purposes
myDict = {"Wubba": "lubba", "Dub": "dub"}
# Define a dictionary to feed y
myArgDict = {'y': "Why?", 'y0': "Why not?", "q": "Here is a cue!"}
# The 1st elem of myList feeds y
f("myEx", *myList, **myDict)
# x = myEx
# y = Left
# myArgs = ('Right', 'Up', 'Down')
# myKW = {'Wubba': 'lubba', 'Dub': 'dub'}
# ----------------------------------------------------------------------
# y is matched and fed first
# The rest of myArgDict becomes additional arguments feeding myKW
f("myEx", **myArgDict)
# x = myEx
# y = Why?
# myArgs = ()
# myKW = {'y0': 'Why not?', 'q': 'Here is a cue!'}
# ----------------------------------------------------------------------
# The rest of myArgDict becomes additional arguments feeding myArgs
f("myEx", *myArgDict)
# x = myEx
# y = y
# myArgs = ('y0', 'q')
# myKW = {}
# ----------------------------------------------------------------------
# Feed extra arguments manually and append even more from my list
f("myEx", 4, 42, 420, *myList, *myDict, **myDict)
# x = myEx
# y = 4
# myArgs = (42, 420, 'Left', 'Right', 'Up', 'Down', 'Wubba', 'Dub')
# myKW = {'Wubba': 'lubba', 'Dub': 'dub'}
# ----------------------------------------------------------------------
# Without the stars, the entire provided list and dict become x, and y:
f(myList, myDict)
# x = ['Left', 'Right', 'Up', 'Down']
# y = {'Wubba': 'lubba', 'Dub': 'dub'}
# myArgs = ()
# myKW = {}
# ----------------------------------------------------------------------
Предостережения
**
исключительно зарезервировано для словарей.- Необязательное назначение аргумента происходит первым.
- Вы не можете использовать необязательный аргумент дважды.
- Если это применимо,
**
должен прийти после*
всегда.
Из документации Python:
Если позиционных аргументов больше, чем слотов формальных параметров, возникает исключение TypeError, если только не присутствует формальный параметр, использующий синтаксис "*identifier"; в этом случае этот формальный параметр получает кортеж, содержащий избыточные позиционные аргументы (или пустой кортеж, если не было лишних позиционных аргументов).
Если какой-либо аргумент ключевого слова не соответствует формальному имени параметра, возникает исключение TypeError, если только нет формального параметра, использующего синтаксис "** идентификатор"; в этом случае этот формальный параметр получает словарь, содержащий избыточные аргументы ключевого слова (используя ключевые слова в качестве ключей и значения аргументов в качестве соответствующих значений), или (новый) пустой словарь, если не было избыточных аргументов ключевого слова.
*
означает получать переменные аргументы в виде списка
**
означает получать переменные аргументы как словарь
Используется как следующее:
1) одиночный *
def foo(*args):
for arg in args:
print(arg)
foo("two", 3)
Выход:
two
3
2) Сейчас**
def bar(**kwargs):
for key in kwargs:
print(key, kwargs[key])
bar(dic1="two", dic2=3)
Выход:
dic1 two
dic2 3
В Python 3.5 вы также можете использовать этот синтаксис в list
, dict
, tuple
, а также set
дисплеи (также иногда называемые литералами). См. PEP 488: Дополнительные обобщения распаковки.
>>> (0, *range(1, 4), 5, *range(6, 8))
(0, 1, 2, 3, 5, 6, 7)
>>> [0, *range(1, 4), 5, *range(6, 8)]
[0, 1, 2, 3, 5, 6, 7]
>>> {0, *range(1, 4), 5, *range(6, 8)}
{0, 1, 2, 3, 5, 6, 7}
>>> d = {'one': 1, 'two': 2, 'three': 3}
>>> e = {'six': 6, 'seven': 7}
>>> {'zero': 0, **d, 'five': 5, **e}
{'five': 5, 'seven': 7, 'two': 2, 'one': 1, 'three': 3, 'six': 6, 'zero': 0}
Это также позволяет распаковывать несколько итераций за один вызов функции.
>>> range(*[1, 10], *[2])
range(1, 10, 2)
(Спасибо mgilson за ссылку PEP.)
TL;DR
Он упаковывает аргументы, переданные функции в list
а также dict
соответственно внутри тела функции. Когда вы определяете сигнатуру функции следующим образом:
def func(*args, **kwds):
# do stuff
он может быть вызван с любым количеством аргументов и аргументов ключевого слова. Аргументы без ключевых слов упаковываются в список args
внутри тела функции и аргументы ключевого слова упакованы в dict под названием kwds
внутри тела функции.
func("this", "is a list of", "non-keyowrd", "arguments", keyword="ligma", options=[1,2,3])
Теперь внутри тела функции, когда функция вызывается, есть две локальные переменные, args
который представляет собой список, имеющий значение ["this", "is a list of", "non-keyword", "arguments"]
а также kwds
который является dict
имеющий значение {"keyword" : "ligma", "options" : [1,2,3]}
Это также работает в обратном порядке, то есть со стороны вызывающего абонента. например, если у вас есть функция, определенная как:
def f(a, b, c, d=1, e=10):
# do stuff
Вы можете вызвать его, распаковав итерации или сопоставления, которые есть в области вызова:
iterable = [1, 20, 500]
mapping = {"d" : 100, "e": 3}
f(*iterable, **mapping)
# That call is equivalent to
f(1, 20, 500, d=100, e=3)
Я хочу привести пример, который другие не упомянули
* также можно распаковать генератор
Пример из Документа Python3
x = [1, 2, 3]
y = [4, 5, 6]
unzip_x, unzip_y = zip(*zip(x, y))
unzip_x будет [1, 2, 3], unzip_y будет [4, 5, 6]
Zip() получает несколько аргументов iretable и возвращает генератор.
zip(*zip(x,y)) -> zip((1, 4), (2, 5), (3, 6))
Опираясь на ответ Никда...
def foo(param1, *param2):
print(param1)
print(param2)
def bar(param1, **param2):
print(param1)
print(param2)
def three_params(param1, *param2, **param3):
print(param1)
print(param2)
print(param3)
print(foo(1, 2, 3, 4, 5))
print("\n")
print(bar(1, a=2, b=3))
print("\n")
print(three_params(1, 2, 3, 4, s=5))
Выход:
1
(2, 3, 4, 5)
1
{'a': 2, 'b': 3}
1
(2, 3, 4)
{'s': 5}
По сути, любое количество позиционных аргументов может использовать *args, а любые именованные аргументы (или аргументы ключевого слова kwargs или aka) могут использовать **kwargs.
В дополнение к вызовам функций, *args и ** kwargs полезны в иерархиях классов и также избегают необходимости писать __init__
метод в Python. Подобное использование можно увидеть в таких фреймворках, как код Django.
Например,
def __init__(self, *args, **kwargs):
for attribute_name, value in zip(self._expected_attributes, args):
setattr(self, attribute_name, value)
if kwargs.has_key(attribute_name):
kwargs.pop(attribute_name)
for attribute_name in kwargs.viewkeys():
setattr(self, attribute_name, kwargs[attribute_name])
Подкласс может быть
class RetailItem(Item):
_expected_attributes = Item._expected_attributes + ['name', 'price', 'category', 'country_of_origin']
class FoodItem(RetailItem):
_expected_attributes = RetailItem._expected_attributes + ['expiry_date']
Подкласс затем будет создан как
food_item = FoodItem(name = 'Jam',
price = 12.0,
category = 'Foods',
country_of_origin = 'US',
expiry_date = datetime.datetime.now())
Кроме того, подкласс с новым атрибутом, который имеет смысл только для этого экземпляра подкласса, может вызывать базовый класс. __init__
снять настройку атрибутов. Это делается с помощью * args и ** kwargs. kwargs в основном используется для того, чтобы код читался с использованием именованных аргументов. Например,
class ElectronicAccessories(RetailItem):
_expected_attributes = RetailItem._expected_attributes + ['specifications']
# Depend on args and kwargs to populate the data as needed.
def __init__(self, specifications = None, *args, **kwargs):
self.specifications = specifications # Rest of attributes will make sense to parent class.
super(ElectronicAccessories, self).__init__(*args, **kwargs)
которые могут быть установлены как
usb_key = ElectronicAccessories(name = 'Sandisk',
price = '$6.00',
category = 'Electronics',
country_of_origin = 'CN',
specifications = '4GB USB 2.0/USB 3.0')
Полный код здесь
Учитывая функцию, которая имеет 3 элемента в качестве аргумента
sum = lambda x, y, z: x + y + z
sum(1,2,3) # sum 3 items
sum([1,2,3]) # error, needs 3 items, not 1 list
x = [1,2,3][0]
y = [1,2,3][1]
z = [1,2,3][2]
sum(x,y,z) # ok
sum(*[1,2,3]) # ok, 1 list becomes 3 items
Представьте себе эту игрушку с мешком из треугольника, круга и прямоугольника. Эта сумка не подходит. Вам нужно распаковать сумку, чтобы взять эти 3 предмета, и теперь они подходят. Оператор Python * выполняет этот процесс распаковки.
*args
а также **kwargs
: позволяет передавать переменное число аргументов в функцию.
*args
: используется для отправки списка аргументов переменной длины без ключа в функцию:
def args(normal_arg, *argv):
print ("normal argument:",normal_arg)
for arg in argv:
print("Argument in list of arguments from *argv:", arg)
args('animals','fish','duck','bird')
Будет производить:
normal argument: animals
Argument in list of arguments from *argv: fish
Argument in list of arguments from *argv: duck
Argument in list of arguments from *argv: bird
**kwargs*
**kwargs
позволяет передавать ключевую переменную длины аргументов в функцию. Вы должны использовать **kwargs
если вы хотите обрабатывать именованные аргументы в функции.
def who(**kwargs):
if kwargs is not None:
for key, value in kwargs.items():
print ("Your %s is %s." %(key,value))
who (name="Nikola", last_name="Tesla", birthday = "7.10.1856", birthplace = "Croatia")
Будет производить:
Your name is Nikola.
Your last_name is Tesla.
Your birthday is 7.10.1856.
Your birthplace is Croatia.
Хороший пример использования обоих в функции:
>>> def foo(*arg,**kwargs):
... print arg
... print kwargs
>>>
>>> a = (1, 2, 3)
>>> b = {'aa': 11, 'bb': 22}
>>>
>>>
>>> foo(*a,**b)
(1, 2, 3)
{'aa': 11, 'bb': 22}
>>>
>>>
>>> foo(a,**b)
((1, 2, 3),)
{'aa': 11, 'bb': 22}
>>>
>>>
>>> foo(a,b)
((1, 2, 3), {'aa': 11, 'bb': 22})
{}
>>>
>>>
>>> foo(a,*b)
((1, 2, 3), 'aa', 'bb')
{}
Этот пример поможет вам вспомнить *args
, **kwargs
и даже super
и наследование в Python сразу.
class base(object):
def __init__(self, base_param):
self.base_param = base_param
class child1(base): # inherited from base class
def __init__(self, child_param, *args) # *args for non-keyword args
self.child_param = child_param
super(child1, self).__init__(*args) # call __init__ of the base class and initialize it with a NON-KEYWORD arg
class child2(base):
def __init__(self, child_param, **kwargs):
self.child_param = child_param
super(child2, self).__init__(**kwargs) # call __init__ of the base class and initialize it with a KEYWORD arg
c1 = child1(1,0)
c2 = child2(1,base_param=0)
print c1.base_param # 0
print c1.child_param # 1
print c2.base_param # 0
print c2.child_param # 1
*args (или * any) означает очень параметры
def any_param(*param):
pass
any_param(1)
any_param(1,1)
any_param(1,1,1)
any_param(1,...)
ВНИМАНИЕ : вы не можете передавать параметры в * args
def any_param(*param):
pass
any_param() # will work correct
* Args находится в кортеже типа
def any_param(*param):
return type(param)
any_param(1) #tuple
any_param() # tuple
для доступа к элементам не используйте *
def any(*param):
param[0] # correct
def any(*param):
*param[0] # incorrect
** kwd
** kwd или ** любой Это тип словаря
def func(**any):
return type(any) # dict
def func(**any):
return any
func(width="10",height="20") # {width="10",height="20")
Контекст
- Python 3.x
- распаковка с
**
- использовать с форматированием строки
Использовать с форматированием строки
В дополнение к ответам в этой ветке есть еще одна деталь, которая больше нигде не упоминалась. Это расширяет ответ Брэда Соломона.
Распаковка с **
также полезно при использовании python str.format
.
Это несколько похоже на то, что вы можете делать с Python f-strings
f-строка, но с дополнительными накладными расходами на объявление dict для хранения переменных (f-строка не требует dict).
Быстрый пример
## init vars
ddvars = dict()
ddcalc = dict()
pass
ddvars['fname'] = 'Huomer'
ddvars['lname'] = 'Huimpson'
ddvars['motto'] = 'I love donuts!'
ddvars['age'] = 33
pass
ddcalc['ydiff'] = 5
ddcalc['ycalc'] = ddvars['age'] + ddcalc['ydiff']
pass
vdemo = []
## ********************
## single unpack supported in py 2.7
vdemo.append('''
Hello {fname} {lname}!
Today you are {age} years old!
We love your motto "{motto}" and we agree with you!
'''.format(**ddvars))
pass
## ********************
## multiple unpack supported in py 3.x
vdemo.append('''
Hello {fname} {lname}!
In {ydiff} years you will be {ycalc} years old!
'''.format(**ddvars,**ddcalc))
pass
## ********************
print(vdemo[-1])
— это специальный параметр, который может принимать 0 или более (позиционных) аргументов в качестве кортежа.
это специальный параметр, который может принимать 0 или более аргументов (ключевых слов) в качестве словаря.
* В Python существует 2 типа аргументов: позиционный аргумент и аргумент ключевого слова :
:
Например, может принимать 0 или более аргументов в виде кортежа, как показано ниже:
↓
def test(*args):
print(args)
test() # Here
test(1, 2, 3, 4) # Here
test((1, 2, 3, 4)) # Here
test(*(1, 2, 3, 4)) # Here
Выход:
()
(1, 2, 3, 4)
((1, 2, 3, 4),)
(1, 2, 3, 4)
И при выводе печатаются 4 числа без скобок и запятых:
def test(*args):
print(*args) # Here
test(1, 2, 3, 4)
Выход:
1 2 3 4
И,args
имеет тип кортежа :
def test(*args):
print(type(args)) # Here
test(1, 2, 3, 4)
Выход:
<class 'tuple'>
Но не имеет типа:
def test(*args):
print(type(*args)) # Here
test(1, 2, 3, 4)
Выход (ошибка):
TypeError: type() принимает 1 или 3 аргумента
И нормальные параметры могут быть указаны раньше, как показано ниже:
↓ ↓
def test(num1, num2, *args):
print(num1, num2, args)
test(1, 2, 3, 4)
Выход:
1 2 (3, 4)
Но нельзя поставить перед, как показано ниже:
↓
def test(**kwargs, *args):
print(kwargs, args)
test(num1=1, num2=2, 3, 4)
Выход (ошибка):
SyntaxError: неверный синтаксис
И обычные параметры не могут быть помещены после, как показано ниже:
↓ ↓
def test(*args, num1, num2):
print(args, num1, num2)
test(1, 2, 3, 4)
Выход (ошибка):
TypeError: в test() отсутствуют 2 обязательных аргумента, состоящих только из ключевых слов: 'num1' и 'num2'
Но, если обычные параметры имеют значения по умолчанию, их можно поставить после, как показано ниже:
↓ ↓
def test(*args, num1=100, num2=None):
print(args, num1, num2)
test(1, 2, num1=3, num2=4)
Выход:
(1, 2) 3 4
А также можно поставить после, как показано ниже:
↓
def test(*args, **kwargs):
print(args, kwargs)
test(1, 2, num1=3, num2=4)
Выход:
:
Например, может принимать 0 или более аргументов в качестве словаря, как показано ниже:
↓
def test(**kwargs):
print(kwargs)
test() # Here
test(name="John", age=27) # Here
test(**{"name": "John", "age": 27}) # Here
Выход:
{}
{'name': 'John', 'age': 27}
{'name': 'John', 'age': 27}
И при печати печатаются 2 ключа:
def test(**kwargs):
print(*kwargs) # Here
test(name="John", age=27)
Выход:
name age
И,kwargs
имеет тип словаря :
def test(**kwargs):
print(type(kwargs)) # Here
test(name="John", age=27)
Выход:
<class 'dict'>
Но,*kwargs
и не имеют типа:
def test(**kwargs):
print(type(*kwargs)) # Here
test(name="John", age=27)
def test(**kwargs):
print(type(**kwargs)) # Here
test(name="John", age=27)
Выход (ошибка):
TypeError: type() принимает 1 или 3 аргумента
И нормальные параметры могут быть указаны раньше, как показано ниже:
↓ ↓
def test(num1, num2, **kwargs):
print(num1, num2, kwargs)
test(1, 2, name="John", age=27)
Выход:
1 2 {'name': 'John', 'age': 27}
А также, можно поставить перед, как показано ниже:
↓
def test(*args, **kwargs):
print(args, kwargs)
test(1, 2, name="John", age=27)
Выход:
(1, 2) {'name': 'John', 'age': 27}
И обычные параметры и не могут быть помещены после, как показано ниже:
↓ ↓
def test(**kwargs, num1, num2):
print(kwargs, num1, num2)
test(name="John", age=27, 1, 2)
↓
def test(**kwargs, *args):
print(kwargs, args)
test(name="John", age=27, 1, 2)
Выход (ошибка):
SyntaxError: неверный синтаксис
Для обоих и :
На самом деле, вы можете использовать другие имена для и как показано ниже.*args
и**kwargs
используются условно:
↓ ↓
def test(*banana, **orange):
print(banana, orange)
test(1, 2, num1=3, num2=4)
Выход:
(1, 2) {'num1': 3, 'num2': 4}
def foo(x, y, *args):
pass
def bar(x, y, **kwargs):
pass
Насколько я знаю,*args
представляет собой массив аргументов, разделенных запятой, поэтому, если вы хотитеfoo
выше это будет выглядеть так
foo("x","y",1,2,3,4,5)
так что если ты побежишь
for a in args:
print(a)
он будет печатать аргументы в порядке размещения: 1,2,3...
Хотя это очень легко реализовать и использовать, порядок аргументов здесь имеет большое значение. Таким образом, если первый аргумент должен быть строкой, а второй — целым числом, то если вызывающая сторона напутала с порядком, функция завершится с ошибкой.
**kwargs
Этоkeyword
аргументы, которые представляют собой набор именованных аргументов, которые передаются какkey/value pair
илиdictionary
разделены по,
если несколько. Таким образом, дляbar
ты можешь отправить
bar("x", "y", name="vinod",address="bangalore",country="india")
и может прочитать его в функции индивидуально как
Name = kwargs['name']
Address = kwargs['address']
Чтение
kwargs
не требуется перечислять цикл, и порядок аргументов не имеет значения.
Звездочка '*' в определении функции объединяет несколько позиционных аргументов в один аргумент -кортеж .
>>> def A(*tpl):
... print(tpl)
...
>>> A(6, 7, 8, 9, 0)
(6, 7, 8, 9, 0)
Звездочка '*' в вызове функции разбивает последовательность на отдельные позиционные аргументы.
>>> def B(a, b, c, d, e):
... print(f"{a} {b} {c} {d} {e}")
...
>>> lst = [1,2,3,4,5]
>>>
>>> B(*lst)
1 2 3 4 5
Двойная звездочка ' **' в определении функции объединяет несколько аргументов ключевого слова в один аргумент словаря .
>>> def C(**dic):
... print(dic)
...
>>> C(a=9, b=8, c=7, d=6, e=5)
{'a': 9, 'b': 8, 'c': 7, 'd': 6, 'e': 5}
Двойная звездочка '**' в вызове функции разделяет объект, подобный словарю , на отдельные аргументы ключевого слова.
>>> def D(v,w,x,y,z):
... print(f"{v} {w} {x} {y} {z}")
...
>>> dct = {'z':1, 'y':2, 'x':3, 'w':4, 'v':5}
>>>
>>> D(**dct)
5 4 3 2 1
«Бесконечные» аргументы с *args и **kwargs
*args
и**kwargs
- это просто способ ввода неограниченного количества символов в функции, например:
def print_all(*args, **kwargs):
print(args) # print any number of arguments like: "print_all("foo", "bar")"
print(kwargs.get("to_print")) # print the value of the keyworded argument "to_print"
# example:
print_all("Hello", "World", to_print="!")
# will print:
"""
('Hello', 'World')
!
"""
Самое простое объяснение состоит в том, что * — это *args, который передает кортеж, а ** — это **kwargs, который передает словарь. Это просто общие имена, используемые по умолчанию.
def foo(param1, *param2):
метод может принимать произвольное количество значений для*param2
,def bar(param1, **param2):
метод может принимать произвольное количество значений с ключами для*param2
param1
это простой параметр.
Например, синтаксис для реализации varargs в Java выглядит следующим образом:
accessModifier methodName(datatype… arg) {
// method body
}
*args = *aList = все элементы в списке
**args= ** aDict = все элементы в dict