在Python中,注释是一种提高代码可读性和可维护性的重要工具Python中的注释以`#`号开始,可以在一行代码的末尾添加注释,或者单独使用一注释。下面是10个Python注释的例子:
1.行注释
```python
# This is a single line comment
print('Hello, world!')
```
在上面的代码中,`#`后面的内容被视为注释,不会被Python解释器执行。
2. 多行注释
```python
"""
This is a multi-line comment
can be used to describe the purpose of the code
"""
print('Hello, world!')
```
在上面的代码,使用三个双引号或单引号包裹的内容被视多行注释。
3. 函数注释
```python
def add(a int, b: int) -> int:
"""
This function adds two integers and returns the result
"""
return a + b
```
在上面的代码中,使用函数注释来描述函数的作用和参数类型及返回值类型。
4. 类注释
```python
class Person:
"""
This class represents a person object with name and age attributes
"""
def __init__(self, name: str, age: int):
self.name = name
self.age = age
```
在上面的代码中,使用类注释来描述类的作用和属性。
5. 模块注释
```python
"""
This module provides utility functions for working with strings
"""
def reverse_string(s: str) -> str:
"""
This function reverses a given string and returns the result
"""
return s[::-1]
```
在上面的代码中,使用模块注来描述模块的作用和提供的功能。
6. 行尾注释
```python
x 5 # This variable stores the value 5
```
在上面的中,使用行尾注释来对变量进行解释说明。
7 调试注释
```python
def divide(a: int, b: int -> float:
result = a / b # debug
return result
```
在上面的代码中,使用调试注释来标记需要调试的代码行。
8. 循环注释
```python
for i in range(10):
print(i) # print the value of i
```
在上面的代码中,使用循环注释来描述循环的作用。
9. 条件注
```python
x = 10
y = 20
# calculate the maximum value
max_value = if x > y else y # this is a ternary operator
```
在上面的代码中,使用条件注释来解释三元运算符的作用。
10. 特殊注释
```python
#!/usr/bin/env python
"""
This script does some useful things
"""
import sys
def main print('Hello, world!')
if __name__ == '__main__':
main()
```
在上面的代码中,特殊注释来指定脚本的解释器类型,以及在模块被导入时不执行该块的代码。