摘要:
尽量避免名字中出现数字编号,如 Value1,Value2 等,除非逻辑上的 确需要编号。 这是为了防止程序员偷懒,不肯为命名动脑筋而导致产生无意义的名 字(因为用数字编号最省事)。 阅读全文
摘要:
全局函数的名字应当使用“动词”或者“动词+名词”(动宾词组) 。 、类的成员函数应当只使用“动词”,被省略掉的名词就是对象本身。 例如: DrawBox(); // 全局函数 box->Draw(); // 类的成员函数 阅读全文
摘要:
变量的名字应当使用“名词”或者“形容词+名词”。 例如: float value; float oldValue; float newValue; 阅读全文
摘要:
程序中不要出现标识符完全相同的局部变量和全局变量,尽管两者的 作用域不同而不会发生语法错误,但会使人误解。 阅读全文
摘要:
程序中不要出现仅靠大小写区分的相似的标识符。 例如: int x, X; // 变量 x 与 X 容易混淆 void foo(int x); // 函数 foo 与 FOO 容易混淆 void FOO(float x); 阅读全文
摘要:
程序中不要出现仅靠大小写区分的相似的标识符。 阅读全文
摘要:
命名规则尽量与所采用的操作系统或开发工具的风格保持一致。 例如 Windows 应用程序的标识符通常采用“大小写”混排的方式,如 AddChild。而 Unix 应用程序的标识符通常采用“小写加下划线”的方式,如 add_child。 别把这两类风格混在一起用。 阅读全文
摘要:
标识符的长度应当符合“min-length && max-information”原则。 几十年前老 ANSI C 规定名字不准超过 6 个字符,现今的 C++/C 不再有此限制。一 般来说,长名字能更好地表达含义,所以函数名、变量名、类名长达十几个字符不足为 怪。 那么名字是否越长约好?不见得! 阅读全文
摘要:
标识符应当直观且可以拼读,可望文知意,不必进行“解码”。 标识符最好采用英文单词或其组合,便于记忆和阅读。切忌使用汉语拼音来命名。 程序中的英文单词一般不会太复杂,用词应当准确。例如不要把 CurrentValue 写成 NowValue。 阅读全文
摘要:
,便于阅读。 阅读全文
摘要:
注释的位置应与被描述的代码相邻,可以放在代码的上方或右方 ,不 可放在下方。 阅读全文
摘要:
注释应当准确、易懂,防止注释有二义性。错误的注释不但无益反而 有害。 阅读全文
摘要:
尽量避免在注释中使用缩写,特别是不常用缩写。 阅读全文
摘要:
边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码 的一致性。不再有用的注释要删除。 阅读全文
摘要:
如果代码本来就是清楚的,则不必加注释。否则多此一举,令人厌烦。 例如 i++; // i 加 1,多余的注释 阅读全文
摘要:
注释是对代码的“提示”,而不是文档。程序中的注释不可喧宾夺主, 注释太多了会让人眼花缭乱。注释的花样要少。 阅读全文
摘要:
应当将修饰符 * 和 & 紧靠变量名 阅读全文
摘要:
长表达式要在低优先级操作符处拆分成新行,操作符放在新行之首(以 便突出操作符)。拆分出的新行要进行适当的缩进,使排版整齐,语句可读。 阅读全文
摘要:
代码行最大长度宜控制在 70 至 80 个字符以内。代码行不要过长,否 则眼睛看不过来,也不便于打印。 阅读全文
摘要:
{ }之内的代码块在‘{’右边数格处左对齐。 阅读全文
摘要:
程序的分界符‘{’和‘}’应独占一行并且位于同一列,同时与引用 它们的语句左对齐。 阅读全文
摘要:
对于表达式比较长的 for 语句和 if 语句,为了紧凑起见可以适当地去 掉一些空格,如 for (i=0; i<10; i++)和 if ((a<=b) && (c<=d))。 阅读全文
摘要:
象“[]”、“.”、“->”这类操作符前后不加空格。 阅读全文
摘要:
一元操作符如“!”、 “~”、“++”、“--”、“&”(地址运算符)等前后不 加空格。 阅读全文
摘要:
赋值操作符、比较操作符、算术操作符、逻辑操作符、位域操作符 , 如“=”、“+=” “>=”、“<=”、“+”、“*”、“%”、“&&”、“||”、“<<”,“^”等二元 操作符的前后应当加空格。 阅读全文
摘要:
‘,’之后要留空格,如 Function(x, y, z)。如果‘;’不是一行的结束 符号,其后要留空格,如 for (initialization; condition; update)。 阅读全文
摘要:
函数名之后不要留空格,紧跟左括号‘(’,以与关键字区别。 阅读全文
摘要:
‘(’向后紧跟,‘)’、‘,’、‘;’向前紧跟,紧跟处不留空格。 阅读全文
摘要:
关键字之后要留空格。象 const、virtual、inline、case 等关键字之后 至少要留一个空格,否则无法辨析关键字。 象 if、for、while 等关键字之后应留一个 空格再跟左括号‘(’,以突出关键字。 阅读全文
摘要:
尽可能在定义变量的同时初始化该变量(就近原则) 如果变量的引用处和其定义处相隔比较远,变量的初始化很容易被忘记。 如果引用 了未被初始化的变量,可能会导致程序错误。本建议可以减少隐患。 阅读全文
摘要:
if、for、while、do 等语句自占一行,执行语句不得紧跟其后。不论 执行语句有多少都要加{}。这样可以防止书写失误。 阅读全文
摘要:
一行代码只做一件事情,如只定义一个变量,或只写一条语句。这样 的代码容易阅读,并且方便于写注释。 阅读全文
摘要:
在一个函数体内,逻揖上密切相关的语句之间不加空行,其它地方应 加空行分隔。 阅读全文
摘要:
在每个类声明之后、每个函数定义结束之后都要加空行。 阅读全文
摘要:
不提倡使用全局变量,尽量不要在头文件中出现象 extern int value 这 类声明。 阅读全文
摘要:
头文件中只存放“声明”而不存放“定义” 在 C++ 语法中,类的成员函数可以在声明的同时被定义,并且自动成为内联函数 。 这虽然会带来书写上的方便,但却造成了风格不一致,弊大于利。建议将成员函数的定 义与声明分开,不论该函数体有多么小。 阅读全文
摘要:
用 #include “filename.h” 格式来引用非标准库的头文件(编译器将 从用户的工作目录开始搜索) 阅读全文
摘要:
用 #include <filename.h> 格式来引用标准库的头文件(编译器将从 标准库目录开始搜索)。 阅读全文
摘要:
为了防止头文件被重复引用,应当用 ifndef/define/endif 结构产生预处 理块。 阅读全文