C++编码规范.docVIP

编程规范的说明 An Introduction to C／Ｃ＋＋Coding Conventions 沈阳航空航天大学 军工行业信息与安全应用实验室 2013年3月 为了提高软件开发质量，降低开发周期，增强代码的可重用性和易读性，使软件便于维护，开发人员间便于交流和协作，特总结出开发规范，以为参考。 一 说明 1.1 为什么要有编码规范 编码规范对于程序员而言尤为重要，有以下几个原因： 一个软件的生命周期中，80%的花费在于维护。 几乎没有任何一个软件，在其整个生命周期中，均由最初的开发人员来维护。 编码规范可以改善软件的可读性，可以让程序员尽快而彻底地理解新的代码。 如果你将源码作为产品发布，就需要确任它是否被很好的打包并且清晰无误，一如你已构建的其它任何产品。 为了执行规范，每个软件开发人员必须一致遵守编码规范。每个人！！！ 1.2总体要求 开发的系统具有较强的通用性、申缩性，并有较强的响音速度。同时开发过程中必须严格按照规范，以便于管理和协同开发。 通用性：能适应机构变动。 伸缩性：程序模块化，程序模块能进行任何组合。 规范性：截面统一，原程序和SQL文件便于他人阅读。 1.3版权说明 本书的大部分内容取材于上海贝尔林锐博士的《高质量C++/C编程指南》，现整理汇编成为沈阳航空工业学院计算机学院网络信息安全实验室的内部编程规范，也可作为培训教材。 二 ?命名规范 命名应尽量使用匈牙利命名法，该命名规则的主要思想是“在变量和函数名中加入前缀以增进人们对程序的理解”。例如所有的字符变量均以ch为前缀，若是指针变量则追加前缀p。如果一个变量由ppch开头，则表明它是指向字符指针的指针。匈牙利记法。即：前缀 + 类型 + 变量名1）格式：[m_|s_|g_] type [class name|struct name] variable name2）解释：·m_ ： 类的成员变量·ms_：类的静态成员变量·s_ ：静态全局变量·g_ ：普通全局变量-1-1】CurrentValue写成NowValue。-1-2】min-length max-information”原则。单字符的名字如i,j,k,m,n,x,y,z等，它们通常可用作函数内的局部变量。-1-3】Windows应用程序的标识符通常采用“大小写”混排的方式，如AddChild。而Unix应用程序的标识符通常采用“小写加下划线”的方式，如add_child。别把这两类风格混在一起用。-1-4】 例如： int x, X; // 变量x 与 X 容易混淆 void foo(int x); // foo 与FOO容易混淆 void FOO(float x);-1-5】 【规则2-1-6】 如果命名使用缩写，则应该使用《通用缩写表》（见附录）-1-7】 例如： float value; float oldValue; node objFind; 【规则2-1-8】变量和参数用小写字母开头的单词组合而成。 例如： BOOL bFlag; int iDrawMode; 【规则2-1-9】常量全用大写的字母，用下划线分割单词。 例如： const int MAX = 100; const int MAX_LENGTH = 100; 【规则2-1-10】为了防止某一软件库中的一些标识符和其它软件库中的冲突，可以为各种标识符加上能反映软件性质的前缀。例如三维图形标准OpenGL的所有库函数均以gl开头，所有常量（或宏定义）均以GL开头。 【建议2-1-1】Value1,Value2等，除非逻辑上的确需要编号。这是为了防止程序员偷懒，不肯为命名动脑筋而导致产生无意义的名字（因为用数字编号最省事）。-2-1】 宏命名、枚举名、联合名-2-2】 自定义消息从WM_USER开始。#define?MYAPP_MESSAGE?WM_USER+0x1001 【规则2-2-3】 结构体类型命名必须全部用大写字母，原则上前面以下划线开始；结构体变量命名必须用大小写字母组合，第一个字母必须使用大写字母，必要时可用下划线间隔。对于私有数据区，必须注明其所属的进程。全局数据定义只需注意其用途。 例如： typedef struct{ char chProductName[20]; char chAuthor[20]; unsigned long ulMaxTables; unsigned long ulUsedTables;}_DBS_DATABASE; _DBS_DATABASE GdataBase; 2．3枚举、联合、类 【规则2-3-1】 枚举名加小写前缀en