「Python编程规范」为Python代码添加注释

「Python编程规范」为Python代码添加注释,第1张

功能要求

为Python代码添加注释,对Python程序代码进行说明。

实例代码

'''多行注释开始

下面的代码根据变量x的值计算y

注意代码中使用缩进表示代码块

多行注释结束'''

x = 5

if x > 100:

y = x 5 - 1 # 单行注释:x>100时执行该语句

else:

y = 0 # x <= 100时执行该语句

print(y) # 输出y

运行结果

知识说明

注释用于为程序添加说明性的文字,帮助程序员更好的阅读和理解程序代码。Python解释器会忽略注释的内容,即注释的内容不会被Python解释器执行。

Python注释分为单行注释和多行注释。

单行注释以符号“#”开始,当前行中符号“#”及其后的内容为注释语句。单行注释可以独占一行,也可放在语句末尾。 说明: 在Pycharm中使用“ctrl + /”可以添加/取消单行注释。

多行注释是用3个英文单引号“'''多行注释文本'''”或3个双引号“"""注释文本"""”进行注释。 注意: 由一对三个单引号或一对三个双引号括起来的内容被认为是注释,但不能由三个单引号和三个双引号混合使用。

1 单行注释


Python编程语言的单行注释常以#最初,单行注释能够作为独自的一行放在被注释代码行之上,也能够放在语句或许表达式之后。


实例:


# -- coding: UTF-8 --


print ("hello world!"); #您好,国际


2 多行注释


Python中多行注释运用三个单引号(’’’)或许三个双引号(”””)来标记,而实际上这是多行字符串的书写方法,并不是Python本身提倡的多行注释方法。


实例:


'''


这是多行注释,运用单引号。


这是多行注释,运用单引号。


'''


"""


这是多行注释,运用双引号。


这是多行注释,运用双引号。


"""


3 编码注释


在进行Python开发时,需进行编码声明,如选用UTF-8编码,需在源码上方进行 # -- coding: UTF-8 -- 声明,从Python3开始,Python默许运用UTF-8编码,所以Python3x的源文件不需要特别声明UTF-8编码。


4 平台注释


如果需要使Python程序运行在Windows平台上,需在Python文件的上方加上 #!/usr/bin/python 注释阐明。


关于Python中如何添加注释,青藤小编就和您分享到这里了。如果您对python编程有浓厚的兴趣,希望这篇文章可以为您提供帮助。如果您还想了解更多关于python编程的技巧及素材等内容,可以点击本站的其他文章进行学习。

在python代码编写过程中,养成注释的习惯非常有用,可以让自己或别人后续在阅读代码时,轻松理解代码的含义。
如果是多行注释,可在每行注释前面加“#”号。
:《Python视频教程》
多行注释,也可用3个双引号括起来。
多行注释,还可以用3个单引号括起来。
如需将现有的代码注释掉,可先选中需要注释的代码。
再按Ctrl + / ,这样选中的代码行前均会加上“#”号,表示该代码已经被注释掉了,不会再运行。
以上就是小编分享的关于python如何整段注释的详细内容希望对大家有所帮助,更多有关python教程请关注环球青藤其它相关文章!


欢迎分享,转载请注明来源:内存溢出

原文地址: https://outofmemory.cn/yw/12883615.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2023-05-28
下一篇 2023-05-28

发表评论

登录后才能评论

评论列表(0条)

保存