【C++】C++的命名规则

参考链接Here
C++命名规则
如果想要管理一个稍微复杂一点的体系,针对其中的事物的一套统一、带有层次、清晰明了的命令准则就必不可少而且非常好的工具。
活跃在生物学、化学、军队等各个领域内的大量有识先辈们都曾无数次以实际行动证明了以上的公理的正确性。除了上帝(假设他可以改变世界万物的秩序)以外,相信没有人有实力对它不屑一顾。
在软件开发这一高度抽象而且十分复杂的活动中,命令规则的重要性更显得尤为突出。一套定义梁浩并且完整的,在整个项目中统一使用命令规范将大大提升源代码的可读性和软件的可维护性。
在引入细节之前,先说明一下命令规则的整体原则:

同一性在编写一个子模块或者派生类的时候,需要遵循其基类或整体模块的命令风格,保持命令风格在整体模块的同一性。
标识符组成标识符采用英文单词或其组合,应当直观且可以拼读,可望文知意,用词应当准确。
最小化长度&&最大化信息量原则在保持一个标识符明确意思的同时,应该尽量缩短其长度。
避免过于相似不要出现紧靠大小写区分的标识符,例如“i”“I”,“function”“Function”等。
避免在不同级别的作用域的重名程序中不要出现名字完全相同的局部变量和全局变量,尽管两者的作用域不同而不会发生语法的错误,但是容易使人误解。
正确命名具有互斥意义的标识符用正确的反义词命名具有互斥意义的标识符,如:“nMinValue""nMaxValue”,"GetName()“"SetName()”
避免名字出现数字编号尽量避免名字出现数字的编号,如Value0Value1Value2等,除非逻辑上的确需要编号。这是为了防止程序偷懒,不肯为命名动脑筋从而导致了产生无意义的名字(因为用数字编号最省事)。

类/结构
除了异常类等个别情况(不希望用户把类看作一个普通的、正常类的情况)外,C++类结构的命名应该遵循以下准则:

C++类/结构的命名类的名字都要以大写的字母“C”开头,后跟一个或多个单词。为便于界定,每个单词的首字母需要大写。
推荐的组织形式类的命名推荐用“名词”或者“形容词+名词”的形式,例如:“CAnalyzer”“CFVecteor”

不同于C++类的概念,传统的C结构体的命名规则如下:

传统的C的命名规则传统C结构体的名称全部由大写字母组成,单词间使用下划线界定,例如:“SERVICE_STATUS”,“DRIVER_INFO”

函数

函数的命名函数的名称由一个或者多个单词组成。便于界定,每个单词的首字母要大写。
推荐的组织形式函数名应该使用“动词”或者“动词+名词”(动宾词组)形式。例如:“GetName()”“SetName()”“Erase()”“Reserve()”
保护成员函数保护成员函数的开头应当加上一个下划线“_“以示区分,例如”_SetState()”
私有成员函数类似地,私有成员函数的开头应当加上两个下划线“__”,例如“__DestroyImp()”
虚函数虚函数习惯用"Do"开头,如:“DoRefresh()”,"_DoEncryption()"
回调和事件处理函数回调和事件处理函数习惯以单词"On"开头。例如:"_OnTimer()",“OnExit()”

变量
变量应该是程序中使用最多的标识符了,变量的命名规范可能是一套C++命名准则中最重要的部分。

变量的命名变量名由作用于前缀+类型的缀+一个或多个单词组成。为了便于界定,每个单词的首字母要大写。对于某些用途简单明了的局部变量,也可以使用简化的方式,如:i,j,k,x,y,z...
作用域前缀 作用域前缀标明了一个变量的可见范围。作用域可以有以下几种:
前缀说明
局部变量
m_类的成员变量(member
sm_类的静态成员变量(static member
s_静态变量(static
g_外部全局变量(global
sg_静态全局变量(static global
sg_静态全局变量(static global
gg_进程间共享的数据段全局变量(global global)
除非不得已,否则应该尽可能少用全局变量。
类型的缀
前缀说明
n整型和位域变量(number)
e枚举型变量(enumeration)
c字符型变量(char)
b布尔型变量(bool)
f浮点型变量(float)
p指针型变量和迭代子(pointer)
pfn特别针对指向函数指针变量和函数指针(pointer of function)
g数组(grid)
i类的实例(instance)对于经常用到的类,也可以定义一些专门的前缀,如:std::stringstd::wstring类的前缀可以定义为"st",std::vector类的前缀可以定义为"v"等等
类型的缀可以组合使用,例如"gc"表示字符数组,"ppn"表示指向整型的指针的指针等等。
推荐的组成形式变量的名字应当使用"名词"或者"形容词+名词"。例如:"nCode","m_nState","nMaxWidth"...

常量
C++引入了对常量的支持,常量的命名规则如下:

常量的命名规则常量名由类型前缀+全大写字母组成,单词间通过下划线来界定,如cDELIMITER,nMAX_BUFFER…类型前缀的定义和变量命名规则中的相同。

枚举、联合、typedef

枚举、联合以及typdef的命名枚举、联合以及typedef语句生成的类型名全都是大写字母组成,单词间通过下划线界定,如:FAR_PROC,ERROR_TYPE…

宏、枚举值

宏、枚举值的命名宏和枚举值全大写字母组成,单词通过下划线界定,如:ERROR_UNKNOWN,OP_STOP…
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值