锐客网

  1. 首页 > 睿知 > it技术 > >

关于python函数含注释的信息

IT技术代码

Python函数注解使用有哪些注意事项呢？函数注解是关于用户自定义的函数的完全可选的、随意的元数据信息 。
1.无论 Python 本身或者标准库中都没有使用函数注解；本节只是描述了语法 。第三方的项目是自由地为文档 ， 类型检查 ， 以及其它用途选择函数注解 。
2.注解是以字典形式存储在函数的 __annotations__ 属性中，对函数的其它部分没有任何影响 。参数注解（Parameter annotations）是定义在参数名称的冒号后面，紧随着一个用来表示注解的值得表达式 。返回注释（Return annotations）是定义在一个 - 后面 ， 紧随着一个表达式，在冒号与 - 之间 。下面的示例包含一个位置参数，一个关键字参数，和没有意义的返回值注释:
【关于python函数含注释的信息】 def f(ham: 42, eggs: int = 'spam') - "Nothing to see here":
... print("Annotations:", f.__annotations__)
... print("Arguments:", ham, eggs)
...
f('wonderful')
Annotations: {'eggs':
, 'return': 'Nothing to see here', 'ham': 42}
Arguments: wonderful spam
python的注释python中python函数含注释的注释一般分为单行注释、多行注释以及文档注释 。
1、单行注释：在所需注释行前面加上英文#号或使用crtl+/快捷键进行操作 。
2、多行注释：按住鼠标左键python函数含注释，选中所需注释python函数含注释的全部行python函数含注释 ， 按住crtl+/快捷键 。
3、文档注释（也可以理解为多行注释）：是三对英文的双引号或单引号 。
Python有哪几种注释方式python中的注释有单行注释和多行注释：
1、单行注释(行注释)
python中使用#表示单行注释 。单行注释可以作为单独的一行放在被注释代码行之上，也可以放在语句或表达式之后 。
比如：
# 这是一个注释
print("Hello, World!")
①当单行注释作为单独的一行放在被注释代码行之上时，为了保证代码的可读性，建议在#后面添加一个空格，再添加注释内容 。
②当单行注释放在语句或者表达式之后时 ， 同样为了保证代码的可读性，建议注释和语句之间至少要有两个空格 。
2、多行注释(块注释)
当注释内容过多，导致一行无法显示时 ， 就可以使用多行注释 。多行注释用三个单引号'''或者三个双引号 """将注释括起来 。
①单引号(''')
'''
这是多行注释，用三个单引号
这是多行注释，用三个单引号
这是多行注释，用三个单引号
'''
print("Hello, World!")
②双引号(""")
"""
这是多行注释 ， 用三个双引号
这是多行注释，用三个双引号
这是多行注释，用三个双引号
"""
print("Hello, World!")
3、注意
①注释不是越多越好，对于一目了然的代码 ， 不需要添加注释;
②对于复杂的操作，应该在操作开始前写上相应的注释;
③对于不是一目了然的代码，可以在代码之后添加注释;
④绝对不要描述代码，一般阅读代码的人都了解python的语法，只是不知道代码要干什么 。
Python 语句和注释我们将在本节中介绍 Python 语句 ， 缩进以及注释 ， 在本节的最后一部分 ， 还会介绍作为一种特殊类型的 Python 注释Docstring。
Python 语句是给解释器执行的指令 ， 一条 Python 语句包含类似于如下的表达式，
你可以将 Python 语句堪称解释器解释表达式并将其结果存储在变量中的指令 。类似于for,while,print之类的语句具有特殊的含义，我们将在在后面的章节中讨论 。

推荐阅读


上一篇：C语言中错误c213是什么意思，c语言中错误c213是什么意思呀

下一篇：大气gis是什么意思，大气区域