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)

不能这么被调用：