常用程序代码命名规则
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
驼峰法(小驼峰法) 变量一般用小驼峰法标识。驼峰法的意思是除 第一个单词之外,其他单词首字母大写。 Pascal法(大驼峰法) 相比小驼峰法,大驼峰法把第一个单词的首 字母也大写了。常用于类名,函数名,属性, 命名空间
帕斯卡命名法
当变量名和函式名称是由二个或二个以上单 字连结在一起,而构成的唯一识别字时,用 以增加变量和函式的可读性。单字之间不以 空格断开或连接号(-)、底线(_)连结, 第一个单字首字母采用大写字母;后续单字 的首字母亦用大写字母,每一个单字的首字 母都采用大写字母的命名格式,源自于 Pascal语言的命名惯例,也有人称之为“大 驼峰式命名法”(Upper Camel Case), 为驼峰式大小写的子集。
建议
说明:应该在源文件的开始之处,对文件中所使用的缩写或 约定,特别是特殊的缩写,进行必要的注释说明。 自己特有的命名风格,要自始至终保持一致,不可来回变化。 说明:个人的命名风格,在符合所在项目组或产品组的命 名规则的前提下,才可使用。(即命名规则中没有规定到的 地方才可有个人命名风格)。 对于变量命名,禁止取单个字符(如i、j、k...),建议除 了要有具体含义外,还能表明其变量类型、数据类型等,但i、 j、k作局部循环变量是允许的。 说明:变量,尤其是局部变量,如果用单个字符表示,很 容易敲错(如i写成j),而编译时又检查不出来,有可能为 了这个小小的错误而花费大量的查错时间。
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函数的远指针
下划线命名法
划线法是随着C语言的出现流行起来的,在 UNIX/LIUNX这样的环境,以及GNU代码 中使用非常普遍,用小写字母和下划线来构 成变量或函数名,每个逻辑断点处用下划线 来标记。
建议
标识符的命名要清晰、明了,有明确含义, 同时使用完整的单词或大家基本可以理解的 缩写,避免使人产生误解。尽可能不使用阿 拉伯数字,更切忌使用中文拼音的首字母。 说明:较短的单词可通过去掉“元音”形 成缩写;较长的单词可取单词的头几个字母 形成缩写;一些单词有大家公认的缩写。 命名中若使用特殊约定或缩写,则要有注释 说明。
建议
这样可以防止局部变量与全局变量重名。 命名规范必须与所使用的系统风格保持一致,并 在同一项目中统一。在同一软件产品内,应规划 好接口部分标识符(变量、结构、函数及常量) 的命名,防止编译、链接时产生冲突。 说明:对接口部分的标识符应该有更严格限制, 防止冲突。如可规定接口部分的变量与常量之前 加上“模块”标识等。 用正确的反义词组命名具有互斥意义的变量或相 反动作的函数等。
常用程序代码命名规范
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) 一般前缀命名规范 前缀 类型 实例
骆驼(Camel)命名法
骆驼式命名法(Camel-Case)一词来自 Perl 语言中普遍使用的大小写混合格式,而 Larry Wall 等人所著的畅销书 《Programming Perl》的封面图片正是一 匹骆驼。 骆驼式命名法的命名规则可视为 一种惯例,并无绝对与强制,为的是增加识 别和可读性。
建议
方法命名时要能说明方法 的用途,通常取动词或动词 短语,也可以是名词或名词 短语。
谢谢大家!