了解方法签名的 Python 帮助输出中的斜杠
使用 Python 的 help() 函数时,用户可能会在方法的输出中遇到斜杠签名。本文揭开了这个符号的神秘面纱,提供了对其重要性的见解。
仅位置参数
斜杠 (/) 表示仅位置参数的结尾在方法签名内。这些参数不能作为关键字参数传入,这意味着它们必须按正确的顺序指定。在 Python 3.8 之前,仅位置参数仅限于 C API。
示例:包含方法
例如,在帮助中range 对象的 __contains__ 方法的输出,斜杠表示键参数只能由position:
>>> help(range.__contains__) ... __contains__(self, key, /) Return key in self. ...
这意味着诸如 range(5).__contains__(key=3) 之类的语法无效,因为 key 参数必须通过位置传递: range(5).__contains__(3) .
Argument Clinic 文档
Argument Clinic 文档提供了更多信息澄清:
要在 Argument Clinic 中将所有参数标记为仅位置参数,请在最后一个参数后面单独添加一个 / ,缩进与参数行相同。
Python FAQ 和 PEP 570
最近,Python FAQ 还解决了仅位置问题参数:
函数参数列表中的斜杠表示其之前的参数仅是位置参数。
此外,PEP 570 将仅位置参数的语法编入了 Python 中自版本 3.8 起的语言规范。
Positional-Only 的优点参数
使用仅位置参数有几个优点:
以上是Python 的 `help()` 输出中的正斜杠对于方法签名意味着什么?的详细内容。更多信息请关注PHP中文网其他相关文章!