Python语句和注释

我们将在本节中介绍Python语句,缩进以及注释,在本节的最后一部分,还会介绍作为一种特殊类型的Python注释Docstring

Python语句:

Python语句是给解释器执行的指令,一条Python语句包含类似于如下的表达式,

result = x + y

你可以将Python语句堪称解释器解释表达式并将其结果存储在变量中的指令。类似于 for, while, print 之类的语句具有特殊的含义,我么将在在后面的章节中讨论。

Python多行语句:

当你在一句语句结束时按回车键后,该Python语句被终止,我们可称之为单行语句。Python中的多行语句可以通过使用行连续字符\来创建,它将Python语句扩展为多行语句。

比如下面的例子,

x = 100 + 101 + 102 \
    + 103 + 104 \
    + 105

这可以被称作明确的多行接续。

你还可以使用括号(),方括号[]或大括号{}来进行隐式的多行接续。

例如,你可以使用括号来连接多行语句,

x = (100 + 101 + 102 
    + 103 + 104 
    + 105)

Python缩进:

Python语句块,例如函数,循环或类的主体,以缩进来开头。对于语句块内的每个语句,应该保持相同的缩进。当缩进不一致时,你将得到IndentationError

一般来说,在Python代码样式指南中建议使用4个缩进空格。举例如下,

x = {1, 2, 3, 4}
for i in x:
    print(i)

我们用缩进来增加程序的可读性,比如在下面的程序中,我们用两种方式来完成同一个功能,

x = {1, 2, 3, 4}
for i in x:
    print(i)

for i in x: print(i)

你可以在这里看到第一个例子比第二个例子有更好的可读性。

Python注释:

注释用于描述程序的目的或工作工程,注释是在Python解释过程中被忽略的行,它们不会干扰程序的流程。

如果你正在编写数百行代码,肯定需要添加注释,因为其他人在阅读你的代码的时候,没有足够的时间阅读每一行来理解代码的工作。程序的注释增加了可读性,并解释了代码的工作原理。

Python注释以井号#开始

#Single Line comment
#Program to print a string
print("Hello Python Programmer")

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 """.

"""Multi-line
comments in 
Python Programming language"""

三重引号'''通常可以用来定义多行文档注释Docstring,你也可以用它来做为另外一种在Python中添加多行注释的方法。

Python文档字符串 Docstring

Docstring是文档字符串,它通常是Python函数,类,模块等的第一条语句。函数,方法和类的描述和注释位于文档字符串(文档字符串)内。

举例如下,

def sum(a, b):
    """This function adds two values"""
    return a+b

一目了然,Docstring介绍了函数的功能。