前一个是/*,后一个是*/。
例子:注释“你好”。
//你好 表示只注释一行。
/* */ 表示注释这里的,不管有几段。
/* 表示后面的都是注释。
分节符
仅可以将文档内容划分为不同的页面,而且还可以分别针对不同的节,进行页面设置 *** 作。
(1)文档编排中,首页、目录等的页眉页脚、页码与正文部分需要不同,那么将首页、目录等作为单独的节。
(2)在文档中,包括封面、目录和正文几个部分,一般情况下,若设置页码,所有页面按顺序编号,正文部分的页码编号不能从1开始。此时,可以通过插入分节符,分成若干节,设置每节的页面格式为横向或纵向,从1开始编号。
// 表示这一行//后面的内容注释掉
/* 表示下一个*/之前的内容注释掉
#include <stdio> //这是注释int main(){
return 0
/* 这都是注释
这都是注释
这都是注释
这都是注释*/
}
以注释内容开始。
关于程序中注释书写格式
1程序文件注释:
放在程序名称空间引用(using System.IO)的上面,主要写公司的版权、文件创建的时间、文件的主要内容、文件的名字、文件的创建标识(创建人姓名)、文件修改的时间、文件修改时的修改标识(修改人姓名)、文件修改的修改原因等(详情见文档后备注示例);
2类的作用注释:
放在类(类、接口、枚举、结构体)的声明上方,主要描述类的作用。
如果类的结构比较复杂,也应该添加类的使用示例和类的流程(其它特点)
3、类的私有全局重要变量注释:
放在类的全局变量声明上方,主要需要注释通过命名不能正确理解的全局私有或公有(包含受保护等)变量。如果是object(特殊数组等)型变量,内部使用时结构比较复杂或有规定,需要简要的说明一下内部结构。
4、类的属性的注释:
放在类的属性声明上方,简要说明属性的类型和主要作用。
5、类的公有方法的注释:
主要说明方法的作用,方法各参数的意义和要求,方法的返回值及各种可能的返回值的特殊意义,方法可能会产生的异常,如果需要,则可以写出方法的使用示例;
6、类的私有方法或重要算法的注释:
除了需要说明公有方法所要求的之外,如果算法、数学运算比较复杂,需要写出算法或数学方法的理论过程或推导过程;如果算法比较长,要尽可能的细分成逻辑块,并填写适当的注释;对于方法中的重要变量也要添加适当的注释,特别是对方法的结果或方法某一段的结果的方法内部不易理解的变量要添加合适的注释;对于特别复杂(重要)的方法,要添加适当的流程图或文档,给以充分的文字、图解等说明;
7、文件、类或类的方法修改后的注释的变更:
对于对文件或类(包括接口、枚举、结构体)或类的方法修改后,要添加修改后的相注释,要写清修改的时间、修改标识(修改人姓名)、修改的原因等一切必要的信息和一切必要变更的信息(类、方法的流程);
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)