2012年6月14日星期四

代码风格杂谈

代码风格杂谈


在此,想随便说说几句关于C++程序代码风格的话题。

以前,我所在的项目大组(下载库)的程序代码,基本都是C++代码,一直沿袭的代码风格大致情况描述,如下:

1,内部逻辑
Linux风格,统一小写字符配合下划线。该风格规范为内部使用的代码命名风格。

2,对外接口
驼峰风格,大小写字符配合,单词首字符大写。该风格规范为对外接口使用的代码命名风格。详细参考驼峰式大小写(维基)

大驼峰式命名法(upper camel case):
每一个单字的首字母都采用大写字母,例如:FirstName、LastName、CamelCase,也被称为Pascal命名法。


其实,我一直赞成,推崇这样的代码风格规范。关键一点,其做到了内部逻辑与对外接口之间的明显区分。

--------- 在此分割吧 ---------

现在(其实是去年九月份就开始制定了规则),我们所有涉及的新项目有关于C++代码,其风格均采用统一的“驼峰风格”。

不管内部逻辑与对外接口,函数命名规则均采用大驼峰式命名法
变量命名规则统一为,匈牙利命名法。


相比“以前”和“现在”,个人感觉“现在”不好的地方在于:
(程序的函数)不能从代码命名规则层次上,快速地区分出代码逻辑属于内部处理或对外暴露的。

话说回来了,既然当时讨论会议上,多数同事支持了“现在”的风格,规则已定下,那就安分遵循吧。

其实嘛,只要你在命名规则上做些善意的“手脚”,还是可帮助你较快地区分出其所属的内外逻辑,如:

void InnerFunc1();
void OutterFunc2();

如下示例只是简单说明情况,具体安排设计依具体情况而定。

     / 2012-06-10/ Junkun Huang.
--

最后,推荐良好的代码风格可参考,列表如下:








没有评论:

发表评论