关于python函数注释模板的信息( 二 )


这是多行注释,用三个双引号
这是多行注释,用三个双引号
"""
print("Hello, World!")
3、注意
①注释不是越多越好 , 对于一目了然的代码 , 不需要添加注释;
②对于复杂的操作,应该在操作开始前写上相应的注释;
③对于不是一目了然的代码,可以在代码之后添加注释;
④绝对不要描述代码,一般阅读代码的人都了解python的语法,只是不知道代码要干什么 。
Python函数注解使用有哪些注意事项呢?函数注解是关于用户自定义python函数注释模板的函数的完全可选的、随意的元数据信息 。
1.无论 Python 本身或者标准库中都没有使用函数注解;本节只是描述python函数注释模板了语法 。第三方的项目是自由地为文档python函数注释模板,类型检查,以及其它用途选择函数注解 。
2.注解是以字典形式存储在函数的 __annotations__ 属性中,对函数的其它部分没有任何影响 。参数注解(Parameter annotations)是定义在参数名称的冒号后面 , 紧随着一个用来表示注解的值得表达式 。返回注释(Return annotations)是定义在一个 - 后面,紧随着一个表达式,在冒号与 - 之间 。下面的示例包含一个位置参数,一个关键字参数 , 和没有意义的返回值注释:
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函数注释模板的信息别忘了在本站进行查找喔 。

推荐阅读