python系列教程206——函数注释

朋友们，如需转载请标明出处：https://blog.csdn.net/jiangjunshow

声明：在人工智能技术教学期间，不少学生向我提一些python相关的问题，所以为了让同学们掌握更多扩展知识更好地理解AI技术，我让助理负责分享这套python系列教程，希望能帮到大家！由于这套python教程不是由我所写，所以不如我的AI技术教学风趣幽默，学起来比较枯燥；但它的知识点还是讲到位的了，也值得阅读！想要学习AI技术的同学可以点击跳转到我的教学网站。PS：看不懂本篇文章的同学请先看前面的文章，循序渐进每天学一点就不会觉得难了！

在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': <class 'float'>,'b': （1,10）,'return': <class 'int'>}

下面的例子只是注解了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': <class 'float'>,'b': （1,10）,'return': <class 'int'>}