常用程序代码命名规则.ppt

常用程序代码命名规范,samuel,没有一种命名规则是所有人都赞同的，在这里，我们只是把常用的命名规则罗列出来,常用的3大程序命名规则,匈牙利命名法骆驼（Camel）命名法帕斯卡（Pascal）命名法下划线命名法,匈牙利命名法,Microsoft程序员查尔斯西蒙尼(CharlesSimonyi)提出的。其主要思想是“在变量和函数名中加入前缀以增进人们对程序的理解”。匈牙利命名法关键是：标识符的名字以一个或者多个小写字母开头作为前缀；前缀之后的是首字母大写的一个单词或多个单词组合，该单词要指明变量的用途，但这种命名法对于跨平台移植简直是灾难。,标识符的名字以一个或多个小写字母开头作为前缀，前缀之后的是首字母大写的一个单词或多个单词组合，该单词要指明变量的用途。形式如下：全局变量名范围前缀+下划线+类型前缀+数组前缀+自定义命名局部变量名类型前缀+数组前缀+自定义命名函数命名类型前缀+自定义命名控件命名控件前缀+自定义命名控件事件命名控件名称+下划线+事件名称程序文件命名模块名缩写+自定义命名其特点是含义明确，便于程序维护、提高工作效率，但是繁琐,基本原则是：变量名属性类型对象描述，1、属性：全局变量g_常量c_c+类成员变量m_静态变量s_2、类型部分指针p函数fn无效v句柄h长整型l布尔b浮点型（有时也指文件）f双字dw字符串sz短整型n双精度浮点d计数c（通常用cnt）字符ch（通常用c）整型i（通常用n）字节by字w实型r无符号u3、描述部分最大Max最小Min初始化Init临时变量T（或Temp）源对象Src目的对象Dest4、举例：1）hwnd：h是类型描述，表示句柄，wnd是变量对象描述，表示窗口，所以hwnd表示窗口句柄；pfnEatApple：pfn是类型描述，表示指向函数的指针，EatApple是变量对象描述，所以它表示指向EatApple函数的函数指针变量。g_cch：g_是属性描述，表示全局变量，c和ch分别是计数类型和字符类型，一起表示变量类型，这里忽略了对象描述，所以它表示一个对字符进行计数的全局变量。2）一般前缀命名规范前缀类型实例,C类或结构CDocument，CPrintInfom_成员变量m_pDoc，m_nCustomers3）变量命名规范前缀类型描述实例chchar8位字符chGradechTCHAR如果_UNICODE定义，则为16位字符chNamebBOOL布尔值bEnablenint整型（其大小依赖于操作系统）nLengthnUINT无符号值（其大小依赖于操作系统）nHeightwWORD16位无符号值wPoslLONG32位有符号整型lOffsetdwDWORD32位无符号整型dwRangep*指针pDoclpFAR*远指针lpszNamelpszLPSTR32位字符串指针lpszNamelpszLPCSTR32位常量字符串指针lpszNamelpszLPCTSTR如果_UNICODE定义，则为32位常量字符串指针lpszNamehhandleWindows对象句柄hWndlpfncallback指向CALLBACK函数的远指针,骆驼（Camel）命名法,骆驼式命名法（Camel-Case）一词来自Perl语言中普遍使用的大小写混合格式，而LarryWall等人所著的畅销书ProgrammingPerl的封面图片正是一匹骆驼。骆驼式命名法的命名规则可视为一种惯例，并无绝对与强制，为的是增加识别和可读性。,驼峰法（小驼峰法）变量一般用小驼峰法标识。驼峰法的意思是除第一个单词之外，其他单词首字母大写。Pascal法（大驼峰法）相比小驼峰法，大驼峰法把第一个单词的首字母也大写了。常用于类名，函数名，属性，命名空间,帕斯卡命名法,当变量名和函式名称是由二个或二个以上单字连结在一起，而构成的唯一识别字时，用以增加变量和函式的可读性。单字之间不以空格断开或连接号（-）、底线（_）连结，第一个单字首字母采用大写字母；后续单字的首字母亦用大写字母，每一个单字的首字母都采用大写字母的命名格式，源自于Pascal语言的命名惯例，也有人称之为“大驼峰式命名法”（UpperCamelCase），为驼峰式大小写的子集。,下划线命名法,划线法是随着C语言的出现流行起来的，在UNIX/LIUNX这样的环境，以及GNU代码中使用非常普遍，用小写字母和下划线来构成变量或函数名，每个逻辑断点处用下划线来标记。,建议,标识符的命名要清晰、明了，有明确含义，同时使用完整的单词或大家基本可以理解的缩写，避免使人产生误解。尽可能不使用阿拉伯数字，更切忌使用中文拼音的首字母。说明：较短的单词可通过去掉“元音”形成缩写；较长的单词可取单词的头几个字母形成缩写；一些单词有大家公认的缩写。命名中若使用特殊约定或缩写，则要有注释说明。,建议,说明：应该在源文件的开始之处，对文件中所使用的缩写或约定，特别是特殊的缩写，进行必要的注释说明。自己特有的命名风格，要自始至终保持一致，不可来回变化。说明：个人的命名风格，在符合所在项目组或产品组的命名规则的前提下，才可使用。（即命名规则中没有规定到的地方才可有个人命名风格）。对于变量命名，禁止取单个字符（如i、j、k.），建议除了要有具体含义外，还能表明其变量类型、数据类型等，但i、j、k作局部循环变量是允许的。说明：变量，尤其是局部变量，如果用单个字符表示，很容易敲错（如i写成j），而编译时又检查不出来，有可能为了这个小小的错误而花费大量的查错时间。,建议,这样可以防止局部变量与全局变量重名。命名规范必须与所使用的系统风格保持一致，并在同一项目中统一。在同一软件产品内，应规划好接口部分标识符（变量、结构、函数及常量）的命名，防止编译、链接时产生冲突。说明：对接口部分的标识符应该有更严格限制，防止冲突。如可规定接口部分的变量与常量之前加上“模块”标识等。用正确的反义词组命名具有互斥意义的变量或相反动作的函数等。,建议,方法命名时要能说明方法的用途，通常取动词或动词短语，也可以是名词或名词短语。,谢谢大家！,