Python 的函数注释

Python 3.x 引入了函数注释，以增强函数的注释功能，下面是一个普通的自定义函数：

def dog(name, age, species):
    return (name, age, species)

添加了注释的自定义函数：

def dog(name:str, age:(1, 99), species:\'狗狗的品种\') -> tuple:
    return (name, age, species)

如上，可以使用:对参数逐个进行注释，注释内容可以是任何形式，比如参数的类型、作用、取值范围等等，返回值使用->标注，所有的注释都会保存至函数的属性。
查看这些注释可以通过自定义函数的特殊属性__annotations__获取,结果会议字典的形式返回：

dog.__annotations__

# {\'age\': (1, 99), \'name\': str, \'return\': tuple, \'species\': \'狗狗的品种\'}

另外，使用函数注释并不影响默认参数的使用：

def dog(name:str =\'dobi\', age:(1, 99) =3, species:\'狗狗的品种\' =\'Labrador\') -> tuple:
    return (name, age, species)

运行结果：

dog()

# (\'dobi\', 3, \'Labrador\')