C++ 代码命名建议

核心思想: 完全准确地描述出该变量所代表的事物。

好名字通常是在表达 what, 而不是 how。

变量名在 8 到 15 正好。

如果要加限定词, 那么加在最后。 例如: revenuTotal 或 revenueAverage。

作为标记的变量不该有 “flag” 而应该使用枚举和具名常量。‘

临时变量也别叫 “tmp” 而应该体现它的用途。

布尔变量最有用的几个分别是: done, error, found, success 或 ok。
如: sourceFile 换成 sourcFileFound。

枚举则最好加上前缀, 明确那些量都属于一个组。

尤其对于 C++:
1. i 和 j 是整数下标。
2. p 是指针。
3. 常量, typedef 和预处理宏全部大写。
4. 变量名和函数名使用驼峰式。
5. 不用下划线, 除非是 g_val 一类的。

时间: 2024-08-15 01:52:05

C++ 代码命名建议的相关文章

编写更好的jQuery代码的建议

编写更好的jQuery代码的建议 2013/12/05 | 分类: WEB前端, 开发 | 15 条评论 | 标签: JQUERY 分享到:125 本文由 伯乐在线 - yanhaijing 翻译自 Mathew Carella.欢迎加入技术翻译小组.转载请参见文章末尾处的要求. 讨论jQuery和javascript性能的文章并不罕见.然而,本文我计划总结一些速度方面的技巧和我本人的一些建议,来提升你的jQuery和javascript代码.好的代码会带来速度的提升.快速渲染和响应意味着更好的

Python代码风格建议(转)

python 以其结构严格著称,同时也以其命名规范散漫出名,算乱无规矩的命名尤其给开发人员带来理解上的误区. 尤其像python.ruby动态语言,由于在运行期随时可能出现方法或者属性的增减,规则的命名尤其重要. ruby语言本身定义的语法规则较为随意,但却不乏一一对应的隐含规则,使人一目了然.其命名规则甚至渗透进了语言本身的规范当中 在命名规则这一点上python显得没规没距.需要逐步养成一个好的编码命名规范. 本文从各大站点文章中搜集了一些代码风格,命名规范.便于学习参考. 代码风格: 使用

编写高质量JAVA程序代码的建议

--------------------------------------------------------------------------------------------------- 前言:原著<改善JAVA程序的151个建议>有151个建议,我在拜读的过程根据自己的理解合并了其中的几个,并将每个建议的核心要义进行了一次纯手工提炼,以方便想阅读这本书的同行能够更快的掌握这本书的所有核心内容. -------------------------------------------

分享我对代码命名的一点思考和理解

一个软件最后都会落实到代码,而代码,其背后的架构设计或设计思想或模式固然重要,但我觉得更重要的东西则是良好的命名.混乱或错误的命名不仅让我们对代码难以理解,更糟糕的是,会误导我们的思维,导致对代码的理解完全错误.相反,良好的命名,则可以让我们的代码非常容易读懂,也能向读者正确表达事物以及逻辑的本质,从而使得代码的可维护性就大大增强. 另外一点也许大家还没感受到,那就是良好的命名,以及良好的命名习惯,由于我们总是对每个概念的名称要求非常苛刻,我们会思考这个名称所表达的概念是否正确,该名称是否正确表

每个程序员需掌握的20个代码命名

代码中到处都需要命名.作为程序员,我们得给类命名,给变量命名,给函数命名,给参数命名,给命名空间命名,等等等等.下面有20条小贴士能帮助你提高你的命名能力. 1.使用能够表达意图的名字 名字得能告诉我们它要做什么,为什么存在,以及是如何工作的.选择能够表达意图的名字,将更有利于我们理解代码. int elapsedTimeInDays; int daysSinceCreation; int daysSinceModification; int fileAgeInDays;</span> 在上面

每个程序员需掌握的20个代码命名小贴士

代码中到处都需要命名.作为程序员,我们得给类命名,给变量命名,给函数命名,给参数命名,给命名空间命名,等等等等.下面有20条小贴士能帮助你提高你的命名能力. 1.使用能够表达意图的名字 名字得能告诉我们它要做什么,为什么存在,以及是如何工作的.选择能够表达意图的名字,将更有利于我们理解代码. <span style="font-size:14px;">int d; // elapsed time in days int elapsedTimeInDays; int days

每一个程序猿需掌握的20个代码命名小贴士

代码中到处都须要命名.作为程序猿.我们得给类命名,给变量命名,给函数命名,给參数命名.给命名空间命名,等等等等.以下有20条小贴士能帮助你提高你的命名能力. 1.使用可以表达意图的名字 名字得能告诉我们它要做什么,为什么存在,以及是怎样工作的.选择可以表达意图的名字.将更有利于我们理解代码. <span style="font-size:14px;">int d; // elapsed time in days int elapsedTimeInDays; int days

20个编写现代CSS代码的建议

明白何谓Margin Collapse 不同于其他很多属性,盒模型中垂直方向上的Margin会在相遇时发生崩塌,也就是说当某个元素的底部Margin与另一个元素的顶部Margin相邻时,只有二者中的较大值会被保留下来,可以从下面这个简单的例子来学习: .square { width: 80px; height: 80px; } .red { background-color: #F44336; margin-bottom: 40px; } .blue { background-color: #2

代码命名规范

该篇日志是一篇阅读材料的总结.文件下载地址:https://class.stanford.edu/c4x/Engineering/CS-144/asset/Naming.pdf (也可从百度云盘下载:http://pan.baidu.com/s/1hqf6KIw).总结如下: 名称应该反映代码作者的目的. 这节省了不必要的注释(如 int t; // Time since born in days 可以改为 int daysSinceBorn;),并使代码变得易于读懂.易读和易于互相讨论,这将是