函数注解 是关于用户自定义的函数的完全可选的、随意的元数据信息.无论 Python 本身或者标准库中都没有使用函数注解；本节只是描述了语法.第三方的项目是自由地为文档,类型检查,以及其它用途选择函数注解.
注解是以字典形式存储在函数的 __annotations__ 属性中,对函数的其它部分没有任何影响.参数注解（Parameter annotations）是定义在参数名称的冒号后面,紧随着一个用来表示注解的值得表达式.返回注释（Return annotations）是定义在一个 - 后面,紧随着一个表达式,在冒号与 - 之间.下面的示例包含一个位置参数,一个关键字参数,和没有意义的返回值注释:
... print("Annotations:", f.__annotations__)
... print("Arguments:", ham, eggs)
...
f('wonderful')
Annotations: {'eggs':
Arguments: wonderful spam
我们将在本节中介绍 Python 语句,缩进以及注释,在本节的最后一部分,还会介绍作为一种特殊类型的 Python 注释 Docstring .
Python 语句是给解释器执行的指令,一条 Python 语句包含类似于如下的表达式,
你可以将 Python 语句堪称解释器解释表达式并将其结果存储在变量中的指令.类似于 for , while , print 之类的语句具有特殊的含义,我们将在在后面的章节中讨论.
当你在一句语句结束时按回车键后,该 Python 语句被终止,我们可称之为单行语句.Python 中的多行语句可以通过使用连续字符 来创建,它将 Python 语句扩展为多行语句.
比如下面的例子,
这可以被称作明确的多行接续.
你还可以使用括号 () ,方括号 [] 或大括号 {} 来进行隐式的多行接续.
例如,你可以使用括号来连接多行语句,
Python 语句块,例如函数,循环或类的主体,以缩进来开头.对于语句块内的每个语句,应该保持相同的缩进.当缩进不一致时,你将得到什么什么 IndentationError .
一般来说,在
Python 代码样式指南
我们用缩进来增加程序的可读性,比如在下面的程序中,我们用两种方式来完成同一个功能,
你可以今天这一节看到第一个例子比第二个例子有更好的可读性.
注释用于描述程序的目的或工作工程,注释是在 Python 解释过程中被忽略的行为,它们不会干扰程序的流程.
如果你正在编写数百行代码,肯定需要添加注释,因为其他人在阅读你的代码的时候,没有足够的时间阅读每一行来理解代码的工作.程序的注释增加了可读性,并解释了代码的工作原理.
Python 注释以井号 # 开始
Using hash symbol in each line can define a multi-line comment. But there is another way to add a multi-line comment in Python, that is using triple quotation marks. You can use either ''' or """ .
三重引号 ''' 通常可以用来定义多行文档注释 Docstring ,你也可以用它来作为另外一种在 Python 中添加多行注释的方法.
Docstring 是文档字符串,它通常是 Python 函数,类,模块等的第一条语句.函数,方法和类的描述和注释位于文档字符串（文档字符串）内.
举例如下,
一目了然, Docstring 介绍了函数的功能.
使用井号加一个空格,后面的内容会被当做注释来解析；
使用三个单引号或双引号包裹的内容,会被当做注释来解析,这种写法如果放在print中,可以实现所见即所得的效果,既回车也会直接显示在控制台
这些基础入门的知识,你可以到黑马程序员社区了解一下.或者官网对话框可直接咨询.
在二维坐标图中我们经常对绘制的图形进行标注.在 matplotlib 中比较常用的有text和annotate两种标注方法,其中：
参数说明：
示例
运行结果：
Matplotlib中的annotate函数可用于在图形上给数据添加文本注解,而且支持带箭头的划线工具,非常方便我们在合适的位置添加描述信息.
plt.annotate() 示例
python中的注释有多种,有单行注释,多行注释,批量注释,中文注释也是常用的.
第一段：python单行注释符号(#)：井号(#)常被用作单行注释符号,在代码中使用#时,它右边的任何数据都会被忽略,当做是注释.print 1 #输出1,#号右边的内容在执行的时候是不会被输出的.
第二段：批量、多行注释符号：在python中也会有注释有很多行的时候,这种情况下就需要批量多行注释符了.多行注释是用三引号''' '''包含的.
python正则表达式的注释方法：学过正则都知道,那简直是天书,为了提高正则的可读性,正则表达式中提供了X(VERBOSE): 详细模式.这个模式下正则表达式可以是多行,忽略空白字符,并可以加入注释.
Python
是完全面向对象的语言.函数、模块、数字、字符串都是对象.并且完全支持继承、重载、派生、多继承,有益于增强源代码的复用性.Python支持重载运算符和动态类型.相对于Lisp这种传统的函数式编程语言,Python对函数式设计只提供了有限的支持.有两个标准库(functools, itertools)提供了Haskell和Standard ML中久经考验的函数式程序设计工具.
①单行注释
Python编程语言的单行注释常以#开头,单行注释可以作为单独的一行放在被注释代码行之上,也可以放在语句或者表达式之后.
实例：
print("hello world!"); #您好,世界
Python中多行注释使用三个单引号(''')或者三个双引号(""")来标记,而实际上这是多行字符串的书写方式,并不是Python本身提倡的多行注释方法.
'''
这是多行注释,使用单引号.
"""
这是多行注释,使用双引号.
以上就是土嘎嘎小编为大家整理的关于python显示函数注释的信息相关主题介绍,如果您觉得小编更新的文章只要能对粉丝们有用,就是我们最大的鼓励和动力,不要忘记讲本站分享给您身边的朋友哦！！