文件名称:给函数参数增加元信息-华为云大数据中台架构分享
文件大小:5.68MB
文件格式:PDF
更新时间:2024-07-01 05:00:34
Python cookbook 中文 参考
用*args 和**kwargs 参数作为输入的函数中插入参数,9.11 小节有一个这样的
例子。
7.3 给函数参数增加元信息
问题
你写好了一个函数,然后想为这个函数的参数增加一些额外的信息,这样的话
其他使用者就能清楚的知道这个函数应该怎么使用。
解决方案
使用函数参数注解是一个很好的办法,它能提示程序员应该怎样正确使用这个
函数。 例如,下面有一个被注解了的函数:
def add(x:int, y:int) -> int:
return x + y
python 解释器不会对这些注解添加任何的语义。它们不会被类型检查,运行时
跟没有加注解之前的效果也没有任何差距。 然而,对于那些阅读源码的人来讲
就很有帮助啦。第三方工具和框架可能会对这些注解添加语义。同时它们也会
出现在文档中。
>>> help(add)
Help on function add in module __main__:
add(x: int, y: int) -> int
>>>
尽管你可以使用任意类型的对象给函数添加注解(例如数字,字符串,对象实例
等等),不过通常来讲使用类或者字符串会比较好点。
讨论
函数注解只存储在函数的 __annotations__ 属性中。例如:
>>> add.__annotations__
{'y':