C语言变量命名规则.doc

1、严格采用阶梯层次组织程序代码：各层次缩进的分格采用VC的缺省风格，即每层次缩进为4格，括号位于下一行。规定相匹配的大括号在同一列，对继行则规定再缩进4格。例如：2、提醒信息字符串的位置在程序中需要给出的提醒字符串，为了支持多种语言的开发，除了一些给调试用的临时信息外，其他所有的提醒信息必须定义在资源中。3、对变量的定义，尽量位于函数的开始位置。二、命名规则：1、变量名的命名规则①、变量的命名规则规定用“匈牙利法则”。即开头字母用变量的类型，其余部分用变量的英文意思或其英文意思的缩写,尽量避免用中文的拼音,规定单词的第一个字母应大写。即：变量名=变量类型+变量的英文意思（或缩写）对非通用的变量，在定义时加入注释说明，变量定义尽量也许放在函数的开始处。见下表：bool(BOOL)用b开头bIsParentbyte(BYTE)用by开头byFlagshort(int)用n开头nStepCountlong(LONG)用l开头lSumchar(CHAR)用c开头cCountfloat(FLOAT)用f开头fAvgdouble(DOUBLE)用d开头dDetavoid(VOID)用v开头vVariantunsignedint（WORD）用w开头wCountunsignedlong(DWORD)用dw开头dwBroadHANDLE（HINSTANCE）用h开头hHandleDWORD用dw开头dwWordLPCSTR(LPCTSTR)用str开头strString用0结尾的字符串用sz开头szFileName对未给出的变量类型规定提出并给出命名建议给技术委员会。②、指针变量命名的基本原则为：对一重指针变量的基本原则为：“p”+变量类型前缀+命名如一个float*型应当表达为pfStat对多重指针变量的基本规则为：二重指针：“pp”+变量类型前缀+命名三重指针：“ppp”+变量类型前缀+命名......③、全局变量用g_开头,如一个全局的长型变量定义为g_lFailCount,即：变量名=g_+变量类型+变量的英文意思（或缩写）④、静态变量用s_开头,如一个静态的指针变量定义为s_plPerv_Inst,即：变量名=s_+变量类型+变量的英文意思（或缩写）⑤、成员变量用m_开头,如一个长型成员变量定义为m_lCount;即：变量名=m_+变量类型+变量的英文意思（或缩写）⑥、对枚举类型（enum）中的变量，规定用枚举变量或其缩写做前缀。并且规定用大写。如：enumcmEMDAYS{EMDAYS_MONDAY;EMDAYS_TUESDAY;……};⑦、对struct、union、class变量的命名规定定义的类型用大写。并要加上前缀，其内部变量的命名规则与变量命名规则一致。结构一般用S开头如：structScmNPoint{intnX;//点的X位置intnY;//点的Y位置};联合体一般用U开头如:unionUcmLPoint{longlX;longlY;}类一般用C开头如：classCcmFPoint{public:floatfPoint;};对一般的结构应当定义为类模板，为以后的扩展性考虑如：templateclassCcmTVector3d{public:TYPEx,y,z;};⑧、对常量（涉及错误的编码）命名，规定常量名用大写，常量名用英文表达其意思。如：#defineCM_FILE_NOT_FOUNDCMMAKEHR(0X20B)其中CM表达类别。⑨、对const的变量规定在变量的命名规则前加入c_,即：c_+变量命名规则；例如：constchar*c_szFileName;2、函数的命名规范：函数的命名应当尽量用英文表达出函数完毕的功能。遵循动宾结构的命名法则，函数名中动词在前,并在命名前加入函数的前缀，函数名的长度不得少于8个字母。例如：longcmGetDeviceCount(……);3、函数参数规范：①、参数名称的命名参照变量命名规范。②、为了提高程序的运营效率，减少参数占用的堆栈，传递大结构的参数，一律采用指针或引用方式传递。③、为了便于其他程序员辨认某个指针参数是入口参数还是出口参数，同时便于编译器检查错误，应当在入口参数前加入const标志。如：……cmCopyString(constchar*c_szSource,char*szDest)4、引出函数规范：对于从动态库引出作为二次开发函数公开的函数，为了能与其他函数以及Windows的函数区分，采用类别前缀+基本命名规则的方法命名。例如：在对动态库中引出的一个图象编辑的函数定义为imgFunctionname(其中img为image缩写)。现给出三种库的命名前缀：①、对通用函数库，采用cm为前缀。②、对三维函数库，采用vr为前缀。③、对图象函数库，采用img为前缀