
上QQ阅读APP看书,第一时间看更新
1.1.1 为程序作注释
程序的第1行:/*第1个C程序*/,是用一个“/*”和一个“*/”这两个对称的符号包括的一些文字,这是标准C语言的固定写法,表示本行文字是个注释。注释的内容不参与程序的运行,它的主要作用是向代码的阅读者做出一些解释,比如程序的主要功能、代码的编辑日志等。另外,注释可以跨越多行,例如:
/* 这是 多行 注释 */
在C99标准中有一种新的注释方式“//”。目前,有一些新的编译器支持C99标准,可以使用这种注释方式,例如:
//这是一行注释
这种用两条斜线开头的注释方法只用于单行注释,由于注释标记“//”位于注释文字的前面,使用起来比较简单。
评价一个程序好坏的标准很多,首先是程序的源代码是否清晰易懂,其次才是程序运行的结果如何。一个结果正确但是源代码不能被别人读懂的程序是“一次性”的,很难被再利用。相反,一个可以被别人读懂的程序不论结果如何总会为其他人提供一些借鉴,而让别人读懂程序的关键之一就是勤加注释。一般来说,每个源代码的开始部分都应该有一个注释,用来说明该程序的编写目标、编写日期、作者、大体结构等。程序中的注释占到整个程序总行数的1/4~1/3。