50 看不懂官档的函数说明怎么办?
有些朋友平时反映,看不懂官方文档中介绍函数的说明,比如:
max(iterable,*[, key, default])
max
函数的几个形参,为什么有*
符号,又有[]
?
函数形参列表中符号 *
表示,后面的形参只能为关键字参数 (keyword argument
),不能为位置参数(positional argument),也就是说,max
函数要这么用:
In [5]: a = [1,2,3,4,2,2,3]
In [6]: max(a,key=lambda x: a.count(x), default=1)
Out[6]: 2
定义函数 f
, 参数 b
位于 *
后面,只能为关键字参数
In [116]: def f(a,*,b):
...: pass
In [117]: f(a,b=1)
In [118]: f(a,1) # 这种调用是错误的
TypeError: f() takes 1 positional argument but 2 were given
再看一个内置函数sum
:
sum(iterable, /, start=0)
看到形参列表中有一个/
,它表示/
前的参数只能是位置参数,不能是关键字参数。
因此,以下调用是合法的:
In [18]: a = [1,3,2,1,4,2]
In [19]: sum(a,2) # start=2表示求和的初始值为2
Out[19]: 15
以下调用是非法的,iterable
参数不能被赋值为关键字实参:
In [23]: sum(iterable=a,start=2)
TypeError: sum() takes no keyword arguments
平时大家更多看到的是这么使用max
函数:
In [7]: max([1,2,3,4,2,2,3])
Out[7]: 4
[]
表示里面的形参是可选项,max
函数可被如下几种形式调用:
max(iterable)
max(iterable,*, key)
max(iterable,*,default)
max(iterable,*, key, default)
不能这么被调用: