C++ 编码规范
一 版式
1.程序块缩进 4 个空格,只能使用空格键,不能使用 TAB 键。
2.相对独立的程序块之间、变量说明之后必须加空行,函数之间也用空行分开。
3.一行只写一条语句,if、for、do、while 等语句自占一行,且执行语句部分无论多少都要加括号 {}。
4.代码行之内应留有适当空格,关键字之后要留空格,函数名之后紧跟左括号,二元操作符前后加空格,一元操作符前后不加空格。
5.程序块的分界符 {和} 应各独占一行并且位于同一列,同时与引用它们的语句左对齐。
二 注释
1.源文件头部应注释生成日期、作者、模块目的 / 功能等。
2.函数头部应注释函数的目的 / 功能、输入参数、输出参数、返回值等。
3.注释应与其描述的代码相近,对代码的注释应放在其上方或右方,变量、常量、宏的注释应放在其上方相邻位置或右方。
三 标识符命名
1.命名尽量使用英文单词,力求简单清楚,避免使用引起误解的词汇。
2.常量、宏和模板名采用全大写的方式,每个单词间用下划线分隔。
3.函数名以大写字母开头,采用谓 - 宾结构。