函数注释
通过help来查看函数的注释
自定义函数时编写函数注释
>>> def exchang(dollar,rate=6.32):
"""
功能:汇率转换,美元 -> 人民币
参数:
- dollar 美元数量
- rate 汇率,默认值是6.32 (2022-03-08)
返回值:
人民币的数量
"""
return dollar*rate
>>> exchang(20)
126.4
类型注释
为函数参数编写类型注释
>>> def times(s:str,n:int) -> str:
return s*n
>>> times('hello',20)
'hellohellohellohellohellohellohellohellohellohellohellohellohellohellohellohellohellohellohellohello'
>>> times(5,5)
25
>>> def times(s:str='FishC',n:int=3) -> str: // 类型注释(字符串)
return s*n
>>> times()
'FishCFishCFishC'
>>> def times(s:list=[1,2,3],n:int=3) -> list: //类型注释为列表
return s*n
>>> times()
[1, 2, 3, 1, 2, 3, 1, 2, 3]
Python自省
在程序运行的时候能够进行自我检测的机制,Python通过一些特有得属性来实现内省
>>> def times(s:list[int], n:int = 3) -> list:
return s * n
>>> times.__name__ //__name__通过name获取函数名
'times'
>>> times.__annotations__ //通过annotations查看函数的类型注释(参数类型和返回值类型)
{'s': <class 'list'>, 'n': <class 'int'>, 'return': <class 'str'>}
>>> exchang.__doc__ //__doc__查看函数文档
'\n\t功能:汇率转换,美元 -> 人民币\n\t参数:\n\t- dollar 美元数量\n\t- rate 汇率,默认值是6.32 (2022-03-08)\n\t返回值:\n\t人民币的数量\n\t'
>>> print(exchang.__doc__) //通过print将转义字符显示出来
功能:汇率转换,美元 -> 人民币
参数:
- dollar 美元数量
- rate 汇率,默认值是6.32 (2022-03-08)
返回值:
人民币的数量