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

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