文档介绍：C++ 命名规范 C++ 命名规范通则: 1 、在所有命名中,都应使用标准的英文单词或缩写。不得使用拼音或拼音缩写, 除非该名字描述的是中文特有的内容, 如半角、全角,声母、韵母等。 2 、所有命名都应遵循达意原则,即名称应含义清晰、明确。 3 、所有命名都不易过长,应控制在规定的最大长度以内。 4 、所有命名都应尽量使用全称。 5、如果命名使用缩写, 则应该使用《通用缩写表》( 见附录) 中的缩写; 原则上不推荐使用《通用缩写表》以外的缩写, 如果使用, 则必须对其进行注释和说明。具体规范: 1 、工程名: 不强制统一。 2 、文件名: · 基于工程名,开头 3 个字母应表明与哪一个工程相关。· 后面的字母应能够区别不同的功能。· 不区分大小写。· 长度不限于 格式,建议不多于 30 个字符。· 若文件用于定义和实现类,建议文件名与类名保持一致。 3 、函数名: · 参照 Windows API 的命名规范。· 推荐使用动宾结构。函数名应清晰反映函数的功能、用途。· 函数名最长不得超过 30 个字符。· 函数名第一个字母必须大写。· 全局函数必须以小写前缀"g" 开头。 4 、变量名: 原则上,变量名的命名遵从匈牙利记法。即:前缀+ 类型+ 变量名 1 )格式: [m_|s_|g_] type [class name|struct name] variable name 2 )解释: · m_: 类的成员变量· ms_ :类的静态成员变量· s_ :静态全局变量· g_ :普通全局变量· 类型缩写( type ) · char, TCHAR : ch · char[] , TCHAR[] : sz · bool, BOOL :b· int, __int16,__int32,__int64 :n · long :l· double :d· float : ft · BYTE : by · WORD :w· DWORD : dw · unsigned :u· function : fn ·p: pointer · lp: pointer 变量名最长不得超过 20 个字符。 5 、类名: · 必须以大写"K" 开头,后面字母反映具体含义,以清晰表达类的用途和功能为原则。· 接口必须以大写"I" 开头,代表 Interface 。· 当名称由多个单词构成时,每一个单词的第一个字母必须大写。 6 、结构名、宏名、枚举名、联合名: · 全部大写。· 枚举名加小写前缀"enum" 。例: typedef enum _KFILE_OPEN_MODE { enumOPEN_READONLY = 0, enumOPEN_READWRITE = 1, enumCREATE_ALWAY =3} KFILE_OPEN_MODE; //· 宏名加小写前缀"def" 。例: #define defMAXNUMBER 100 · 结构名加小写前缀"tag" ,之后必须以大写"K" 开头。例: typedef struct tagKPOINT { int x; int y; } KPOINT; //· 联合名加小写前缀"uni" 。例: typedef union _VARIANT{ char unichVal; int uninVal; long unilVal; float uniftVal; ... } VARIANT; C/C++ 源代码书写规范(试行) /.cpp 的开头应有一段格式统一的说明,内容包括: a. 文件名(FileName) ; b. 创建人(Creater) ; c. 文件创建时间(Date) ; d. 简短说明文件功能、用途(Comment) 。 2. 除非极其简单,否则对函数应有注释说明。内容包括:功能、入口/ 出口参数,必要时还可有备注或补充说明。 3. 每行代码的长度推荐为 80列, 最长不得超过 120 列; 折行以对齐为准。例: HANDLE KSOpenFile(const char cszFileName[], int nMode); 或者: BOOL KSReadFile( HANDLE hFile, void *pvBuffer, int nReadSize, int *pnReadSize ); 4. 循环、分支代码,判断条件与执行代码不得在同一行上。例:正确: if (n == -2) n= 1; else n= 2; 不得写做: if (n == -2) n= 1; else n= 2; 5. 指针的定义, * 号既可以紧接类型,也可以在变量名之前。例:可写做: int* pnsize; 也可写做: int *pnsize; 但不得写做: int * pnsize; 6. 在类的成员函数内