[TOC]

Python 函数参数

前言

最近在跟同事讨论一个方法的调用时涉及到了 Python 函数的位置参数和关键字参数的相关知识，发现之前学习 Python 时对函数参数研究的并不透彻，且很多地方已经有些生疏了，故而查阅了一下 Python 官方文档和廖雪峰的官网中的相关知识，并记录总结如下。

Argument 和 Parameter

Python 函数参数根据使用情况的不同需要分为 Parameter 和 Argument 两部分进行讨论。

Argument

Argument 指的是函数调用时的实际参数，即实参 (actual parameter)，也可以称为引数。
Python 中有两种 Argument，分别是「位置参数」和「关键字参数」

位置参数 [positional argument]

位置参数使用时可以放在参数列表的开头，和/或是以一个被 * 标明的可迭代的元素表示，以内置函数 complex() 的调用为例：

complex(3, 5)
complex(*(3, 5))

关键字参数 [keyword argument]

关键字参数使用时需要用标识符指明（name= 的形式），或是作为一个被 ** 标明的的字典的值进行传递，以内置函数 complex() 的调用为例：

complex(real=3, imag=5)
complex(**{'real': 3, 'imag': 5})

Parameter

Parameter 指的是函数定义时的形式参数，即形参 (formal parameter)。Python 中有五种 Parameter，分别是「位置或关键字参数」、「仅位置参数」、「仅关键字参数」、「可变位置参数」、「可变关键字参数」

位置或关键字参数 [positional-or-keyword]

位置或关键字参数在函数调用时可以以位置参数 (positional argument) 或关键字参数 (keyword argument) 的形式提供。它是默认的参数类型。

def func(foo1, foo2=None): ...

仅位置参数 [positional-only]

仅位置参数在函数调用时只能由位置参数 (positional argument) 提供。Python 没有提供定义该参数的语法，它只在一些内置函数中存在，例如 abs()。

仅关键字参数 [keyword-only]

仅关键字参数在函数调用时只能由关键字参数 (keyword argument) 提供，它可以对函数传入的关键字参数进行限制。
仅关键字参数定义时需要在其之前紧邻一个可变位置参数或增加一个特殊分割符 *。

1. 含有可变位置参数时以可变位置参数为分割，可变位置参数后都是仅关键字参数

def person(name, age, *args, city, job):
    print(name, age, args, city, job)

可以这样调用他

test_arg('beijin','wfp',age='25',job='hoker')
test_arg('beijin','wfp',addr='shanghai',age='25',job='hoker')

但是不能这样调用他

test_arg('beijin','wfp','25',job='hoker')

会提示缺少一个参数，定义了命名关键字参数的话，必须要把全部的关键字参数传入进去

2. 没有可变位置参数时，增加一个 * 作为特殊分隔符，* 后面的都是仅关键字参数

def test_arg(city,name,*,age,job):
    print(name, age, args, city, job)

仅关键字参数可以设置默认值，从而简化调用：

def person(name, age, *, city='Beijing', job):
    print(name, age, city, job)

由于参数 city 具有默认值，调用时，可不传入 city 参数：

>>> person('Jack', 24, job='Engineer')
Jack 24 Beijing Engineer

使用命名关键字参数时，要特别注意，如果没有可变参数，就必须加一个 。如果缺少 * Python 解释器将无法识别 positional-or-keyword 和 keyword-only

可变位置参数 [var-positional]

可变参数很简单，在 C/C++ 和 Java 等语言中都有，就是用 *args 号来表示，例如

def test_arg(*arg): ...

你可以传入任意多个元素（包括0）到参数中，在函数调用时会自动被认为是一个元组

可变关键字参数 [var-keyword]

可变关键字参数在 python 中习惯用 **kw 表示，可以传入0到任意多个“关键字-值”，参数在函数内部被当做一个字典

def test_arg(**kw): ...
def test_arg(city, **kw): ...

可以这样调用它

test_arg(name='John', job='hoker')
test_arg('beijin', name='john')

关键字参数可以用来后期扩充函数的功能，例如：先设定必要的参数，之后选择性的增加可选参数。

参考来源

https://docs.python.org/3.6/glossary.html#term-parameter

https://docs.python.org/3.6/glossary.html#term-argument

https://docs.python.org/3.6/faq/programming.html#faq-argument-vs-parameter

https://www.liaoxuefeng.com/wiki/1016959663602400/1017261630425888