C++格式规范
在C++程序设计中,需要重视程序编码规范。但是在大学四年学习并没有重视程序书写规范化,由于一些教材的程序书写格式五花八门,以至于我在编程设计时缺乏规范化的编码训练,从而影响到毕业求职与工作。
这里特此记录C++书写规范
1.语句
一条语句占一行或者多行,避免一行写多条语句,除非这些语句非常相关。
2.程序注释
程序注释包括段注释和行注释,段注释单独一行或者几行,主要说明下面一段程序完成什么功能,行注释用于解释某条语句的功能。注意注释书写的对齐。
//该函数完成的功能 void SampleFunction() { //段注释1 ------ //行注释1 ====== //行注释2 //段注释2 if(...) { //段注释3 //... } }3.缩进
程序块缩进大小为2到4个空格之间,通常为4个空格,可以将TAB设置为4个空格符。
4.程序块
程序块的花括号有三种写法,推荐第一种或者第二种
//现代C/C++写法 while (!done) { doSomething(); done = moreToDo(); } //传统C/C++ while (!done) { doSomething(); done = moreToDo(); } //GUN写法 while(!done) { doSomething(); done = moreToDo(); }5.空行
在程序中要适当使用空行来表示程序段落。在必要时,程序段落的开始要加上注释,说明该程序段的功能。
函数和函数之间,建议由两行以上的空格。
6.空格
空格使用包含以下情况:
(1)双目运算符前后加上空格,单目运算符前后不要加空格
(2)C++保留字后必须加上空格
(3)逗号后面必须加上空格
(4)for语句中的问号后加空格
a = (b + c) * d; // NOT: a=(b+c)*d while (ture) // NOT: while(ture) { ... doSomething(a, b, c, d); //NOT: doSomething(a,b,c,d); for (i = 0; i < 10; i++) // NOT: for(i=0;i<10;i++) }这几点是所有的代码书写规范中要求的,但也是程序员最容易疏忽的地方。在运算符前后加上空格,可以大大改善复杂表达式和复杂语句的可读性。
7.圆括弧
圆括弧注意以下几点:
(1)不要在关键字后直接跟上圆括弧,中间必须有空格
(2)函数名后直接跟上圆括弧(以示和关键字的区别,但是有些规范中要求和关键字一样加上空格)
(3)函数参数名,括弧和参数之间没有空格(有些规范中有空格,但是多数没有)
(4)return语句后不要用圆括弧(如果不是必须的话)
if (condition) { } while (condition) { } strcpy(s, sl); return 1;8.浮点常量
浮点常量必须有小数点。
double totla = 0.0; // NOT: double total 0; double speed = 3.0e8; // NOT: double speed = 3e8; double sum; sum = (a + b) * 10.0;