第二章--第二节:注释

简介: 第二章--第二节:注释

零、怎么编写注释

编写注释的方式有三种:

1.以 # 开头

2.以三个 开头和结尾

3.以三个 " 开头和结尾

# 定义一个字符串变量
name = '张三'
# 定义一个函数
def GetName():
    return name
def SetName(n):
    '''
    :param n: 姓名
    :return:
    '''
    name = n
def SetAge(age):
    """
    :param age: 年龄
    :return:
    """
    return age

单引号和双引号注释中出现了**:para 参数名:和return:**,param是对每个参数的描述,return是对返回值的描述


一、规则

注释具有两个功能:

1.对所编写的代码解释说明

2.表明编写代码的思路

结合以上两点,我们在编写代码的时候应遵循 简单、明了 。所谓简单明了,就是指要用简练的语言清晰的描述出代码所要做的事情/编写代码的思路。还应注意的是,#注释一般用于函数/方法内的代码注释,单引号和双引号注释一般用于函数/类/方法本身的注释


二、 小结

本节主要讲解了注释的写法,请读者牢记注释的规则


目录
相关文章
|
6月前
|
机器学习/深度学习 编译器 C++
C++模板元模板实战书籍讲解第一章(顺序、分支与循环代码的编写)--续篇
C++模板元模板实战书籍讲解第一章(顺序、分支与循环代码的编写)--续篇
53 0
|
6月前
|
机器学习/深度学习 编译器 C++
C++模板元模板实战书籍讲解第一章(顺序、分支与循环代码的编写)--前篇
C++模板元模板实战书籍讲解第一章(顺序、分支与循环代码的编写)--前篇
35 0
|
11月前
|
编译器 程序员 C语言
C++入门(内容补充)
之前给大家更新了一系列关于C++的基础语法,那么今天小编再给大家进行部分内容的补充,然后我们马上就会进入类有关内容的介绍。
44 0
|
Java 开发工具 开发者
程序基本概念——注释 | 学习笔记
快速学习程序基本概念——注释
212 0
程序基本概念——注释 | 学习笔记
|
Python
Python入门系列第二章--第二节:注释
Python入门系列第二章--第二节:注释
95 0
|
Python
第四章--第二节:类
第四章--第二节:类
84 0
|
存储 Python
第四章--第一节:函数
第四章--第一节:函数
99 0
|
索引 Python
第三章--第三节:列表
第三章--第三节:列表
130 0
第三章--第三节:列表
|
Python
第三章--第二节:循环语句
第三章--第二节:循环语句
73 0
|
测试技术 Python
第三章--第一节:条件判断语句
第三章--第一节:条件判断语句
86 0