美文网首页Python经典基础知识
Pyhton中一些具有特别用处的注释

Pyhton中一些具有特别用处的注释

作者: NJingZYuan | 来源:发表于2019-08-07 20:30 被阅读0次
  1. TODO注释

单行注释“#”号后使用TODO关键字

效果:
1)蓝色高亮显示注释;
2)并能通过Pycharm控制台中TODO下的Project窗口中快捷访问;

作用:
TODO注释可表示当前未完成,将来需要更新完善的代码。

比如:在搭建项目框架时,标识待完成的细节,等待框架搭建完成后再回来完成。

格式:# TODO:后跟注释说明,也可以添加开发人员的名字,表示将来待谁完善的地方

# TODO: 此处代码待日后完善 David
  1. 类型注解

定义函数或者变量时,可以对函数参数、函数返回值和变量类型进行注解。

例:

def add(x: int, y: int = 10) -> int:
    return x + y
a: int = 10
b: str = 'David'

使用: 类型对函数参数或变量类型进行注解;使用-> 类型对函数返回值类型进行注解。

这种注解方式对代码来说没有任何影响,Python解释器也不会因此而进行额外的校验。这么做的好处是:
1)别的程序员能够一眼看出参数或变量类型;
2)IDE能够通过该声明得知类型,从而提供更准确的代码提示、补全和语法检查;

补充:
可通过函数名.__annotations__获取对函数参数和返回值的注解。

print(add.__annotations__)
结果:
{'x': <class 'int'>, 'y': <class 'int'>, 'return': <class 'int'>}
  1. type注释

通过# type:对数据类型进行注释说明。既可向IDE声明数据类型,也能让其他程序员一目了然。

b = a   # type: str

PS:向IDE声明数据类型,其将能提供更准确的代码提示等。

相关文章

  • Pyhton中一些具有特别用处的注释

    TODO注释 单行注释“#”号后使用TODO关键字 效果:1)蓝色高亮显示注释;2)并能通过Pycharm控制台中...

  • 1.6注释、标识符、关键字

    1.注释 1.1注释的概述 注释在程序运行中毫无用处,即不解释也不输出,主要起辅助说明的作用 1.2注释的分类 1...

  • python基础

    pyhton基础 缩进方式 Python的语法比较简单,采用缩进方式。 以#开头的语句是注释。语句以冒号:结尾时,...

  • 注释//TODO的用处(随笔)

    编程中,总是能在一些编译器自动生成的代码或者大佬的程序中看到//TODO ...的注释,一直很疑惑到底是什么意思,...

  • Python中的注释和文档

    下面就Python中的注释做一些演示:单号注释,多行注释,文档注释 1. 单行注释 # This is a sin...

  • 爬虫实战1:Python爬取豆瓣图书,发现言情小说界的霸主居然是

    继入门了Pyhton数据分析之后,我开始了爬虫的学习之路,主要是发现爬虫的用处实在是太大了,招聘信息、爱豆高清美图...

  • Annovar注释细节说明(一)

    Annovar注释结果中Func.refGeneWithVer类型 annovar注释结果中,一些列中的内容需要认...

  • HTML的条件注释

    因为条件注释只能在ie下使用,因此我们可以通过条件注释来为ie添加特别的指令。条件注释是一些if判断,但这些...

  • 2020-08-13 python 内置函数

    学习 pyhton 遇到内置函数,持续笔记中....... round(number ,[digits]) 返回 ...

  • 2018-12-24

    10.1.5 Comment类型 注释在DOM中时通过Common类型是表示的。Common节点具有下列特征:◆ ...

网友评论

    本文标题:Pyhton中一些具有特别用处的注释

    本文链接:https://www.haomeiwen.com/subject/kooadctx.html