Python 调用

说明

《Python 教程》持续更新中，提供建议、纠错、催更等加作者微信: gairuo123（备注：pandas教程）和关注公众号「盖若」ID: gairuo。跟作者学习，请进入 Python学习课程。欢迎关注作者出版的书籍：《深入浅出Pandas》和《Python之光》。

Python 的调用就是带有一些参数来执行一个可调用对象(例如函数)，这个参数可能为空。调用时用圆括号 () 来操作。

简介

主要有以下两种形式的调用:

函数调用

使用函数名加上括号调用函数,括号中可以传入参数,多个参数用逗号隔开:

result = print('Hello') # 调用print()函数
value = max(1, 2, 3) # 调用max()并传入3个参数

方法调用

对一个对象调用其方法,通过.访问对象的方法:

list.append(1) # 调用list的append()方法
string.upper() # 调用string的upper()方法

调用函数或方法时,会暂停当前程序执行,跳转去执行被调用的函数或方法体,当函数/方法执行完毕后再返回到调用的位置,继续执行后面的语句。

调用时可以传入参数,被调用的函数/方法可以访问这些参数。调用结束后,可能会有一个返回值返回。

调用是Python中组织代码的重要方式,通过定义函数/方法一次,可以多次重复调用,大大提高代码的重用性。正确使用调用可以让代码更整洁,逻辑更清晰。

关于参数的传入规则可参考函数的参数。

语法详解

语法的表示式为：

call                 ::=  primary "(" [argument_list [","] | comprehension] ")"
argument_list        ::=  positional_arguments ["," starred_and_keywords]
                            ["," keywords_arguments]
                          | starred_and_keywords ["," keywords_arguments]
                          | keywords_arguments
positional_arguments ::=  positional_item ("," positional_item)*
positional_item      ::=  assignment_expression | "*" expression
starred_and_keywords ::=  ("*" expression | keyword_item)
                          ("," "*" expression | "," keyword_item)*
keywords_arguments   ::=  (keyword_item | "**" expression)
                          ("," keyword_item | "," "**" expression)*
keyword_item         ::=  identifier "=" expression

一个可选项为在位置和关键字参数后加上逗号而不影响语义。

此原型必须求值为一个可调用对象（用户定义的函数，内置函数，内置对象的方法，类对象，类实例的方法以及任何具有 __call__() 方法的对象都是可调用对象）。所有参数表达式将在尝试调用前被求值。请参阅函数定义一节了解正式的 parameter 列表句法。

如果存在关键字参数，它们会先通过以下操作被转换为位置参数。首先，为正式参数创建一个未填充空位的例表。如果有 N 个位置参数，则它们会被放入前 N 个空位。然后，对于每个关键字参数，使用标识符来确定其对应的空位（如果标识符与第一个正式参数名相同则使用第一个空位，依此类推）。如果空位已被填充，则会引发 TypeError 异常。否则，将参数值放入空位，进行填充（即使表达式为 None，它也会填充空位）。当所有参数处理完毕时，尚未填充的空位将用来自函数定义的相应默认值来填充。（函数一旦被定义，其默认值就会被计算；因此，当列表或字典这类可变对象被用作默认值时将会被所有未指定相应空位参数值的调用所共享；这种情况通常应当被避免。）如果任何一个未填充空位没有指定默认值，则会引发 TypeError 异常。在其他情况下，已填充空位的列表会被作为调用的参数列表。

CPython 实现细节：某些实现可能提供位置参数没有名称的内置函数，即使它们在文档说明的场合下有“命名”，因此不能以关键字形式提供参数。在 CPython 中，以 C 编写并使用 PyArg_ParseTuple() 来解析其参数的函数实现就属于这种情况。

如果存在比正式参数空位多的位置参数，将会引发 TypeError 异常，除非有一个正式参数使用了 *identifier 句法；在此情况下，该正式参数将接受一个包含了多余位置参数的元组（如果没有多余位置参数则为一个空元组）。

如果任何关键字参数没有与之对应的正式参数名称，将会引发 TypeError 异常，除非有一个正式参数使用了 **identifier 句法，该正式参数将接受一个包含了多余关键字参数的字典（使用关键字作为键而参数值作为与键对应的值），如果没有多余关键字参数则为一个（新的）空字典。

如果函数调用中出现了 *expression 句法，expression 必须求值为一个 iterable。来自该可迭代对象的元素会被当作是额外的位置参数。对于 f(x1, x2, *y, x3, x4) 调用，如果 y 求值为一个序列 y1, ..., yM，则它就等价于一个带有 M+4 个位置参数 x1, x2, y1, ..., yM, x3, x4 的调用。

这样做的一个后果是虽然 *expression 句法可能出现于显式的关键字参数之后，但它会在关键字参数之前被处理。因此:

def f(a, b):
    print(a, b)

f(b=1, *(2,))
2 1
f(a=1, *(2,))
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: f() got multiple values for keyword argument 'a'
f(1, *(2,))
1 2

在同一个调用中同时使用关键字参数和 *expression 语句并不常见，因此实际上这样的混淆不会发生。

如果函数调用中出现了 **expression，则 expression 必须求值为一个 mapping，其内容会被当作是额外的关键字参数。如果一个形参与一个已给定值关键字相匹配（通过显式的关键字参数，或通过另一个解包），则会引发 TypeError 异常。

当使用 **expression 时，该映射中的每个键都必须为字符串。该映射中的每个值将被赋值给名称与键相同的适用于关键字赋值的第一个正式形参。键名不需要是 Python 标识符（例如 "max-temp °F" 也是可接受的，但它将不能与可被声明的任何正式形参相匹配）。如果键值对未与某个正式形参相匹配则将被 ** 形参所收集，或者如果没有此形参，则会引发 TypeError 异常。

使用 *identifier 或 **identifier 句法的正式参数不能被用作位置参数空位或关键字参数名称。

在 3.5 版更改: 函数调用接受任意数量的 * 和 ** 拆包，位置参数可能跟在可迭代对象拆包 (*) 之后，而关键字参数可能跟在字典拆包 (**) 之后。由 PEP 448 发起最初提议。

除非引发了异常，调用总是会有返回值，返回值也可能为 None。返回值的计算方式取决于可调用对象的类型。

如果类型为：

用户自定义函数: 函数的代码块会被执行，并向其传入参数列表。代码块所做的第一件事是将正式形参绑定到对应参数；相关描述参见函数定义一节。当代码块执行 return 语句时，由其指定函数调用的返回值。
内置函数或方法: 具体结果依赖于解释器；有关内置函数和方法的描述参见内置函数。
类对象: 返回该类的一个新实例。
类实例方法: 调用相应的用户自定义函数，向其传入的参数列表会比调用的参数列表多一项：该实例将成为第一个参数。
类实例: 该类必须定义有 __call__() 方法；作用效果将等价于调用该方法。

参考

https://docs.python.org/zh-cn/3/reference/expressions.html#calls

< Python 序列的切片操作 Python 的表达式和操作运算 Python 赋值表达式(海象运算符) >

更新时间：2023-09-24 11:38:43 标签：python 调用