Python系列学习笔记之函数注解

在Python 3.0中，可以给函数对象附加注解信息。这些信息会附加到函数对象的__annotations__属性。

如下是一个不带注解的函数，它编写为带有3个参数并且返回一个结果：

def func（a,b,c）:

... return a + b + c

...

func（1,2,3）

6

从语法上讲，函数注解编写在def头部行。对于参数，它们出现在紧随参数名之后的冒号之后；对于返回值，它们编写于紧跟在参数列表之后的一个->之后。例如，这段代码，注解了前面函数的3个参数及其返回值：

def func（a: 'spam',b: （1,10）,c: float） -> int:

... return a + b + c

...

func（1,2,3）

6

Python将注解信息收集到字典中并且将它们附加给函数对象自身。参数名变成键，如果编写了返回值注解的话，它存储在键“return”下：

func.annotations

{'a': 'spam','c': ,'b': （1,10）,'return': }

下面的例子只是注解了3个参数中的两个：

def func（a: 'spam',b,c: 99）:

... return a + b + c

...

func（1,2,3）

6

func.annotations

{'a': 'spam','c': 99}

for arg in func. annotations :

... print（arg,'=>',func. annotations [arg]）

...

a => spam

c => 99

如果编写了注解的话，仍然可以对参数使用默认值——注解出现在默认值之前。例如，下面的a: 'spam' = 4意味着参数a的默认值是4，并且用字符串'spam'注解它：

def func（a: 'spam' = 4,b: （1,10） = 5,c: float = 6） -> int:

... return a + b + c

...

func（1,2,3）

6

func（） # 4 + 5 + 6 （all defaults）

15

func（1,c=10） # 1 + 5 + 10 （keywords work normally）

16

func.annotations

{'a': 'spam','c': ,'b': （1,10）,'return': }