大家好,又见面了,我是全栈君,祝每个程序员都可以多学几门语言。
前言
工作中接触了非常多编程规范。当中最有意思的是,公司近期公布了一版C/C++编程规范,然后我看到该规范的最后一段时,有这么一句:“该规范不适用于Windows平台开发”。看来这份规范是由做其它平台开发的同学制定的。那么做Windows开发的人都去哪儿了?后来因为工作须要,项目组须要我制定一份编程规范。这也是我这系列博客的由来。(转载请指明出于breaksoftware的csdn博客)
说到“规范“”,可能没多少人喜欢这种东西。相信非常多project师和我一样,都喜欢互联网的一些特质:自由、兼容并包。己所不欲勿施于人,所以我制定该“规范”时,也是抱着开放的态度——在”规范“之后加了”建议“二字。之后,我都会统称这些条例为“建议”。
假如说指定“规范”是easy的(事实上也不easy),那么最难的是让人遵从。一般假设我们想遵从什么,肯定要先想好我们为什么要遵从,我们遵从之有什么优点,能够给我们带来什么?相同我也是按着这个思维去制定这种“建议”,我将会从代码的可读性、可维护性、健壮性等角度,思考和编制该“建议”。希望这些“建议”能够协助大家写出更易读、更健壮、更好看的代码。
本“建议”条例分为下面若干等级:
【必须】 |
编码必须遵从。 |
【要求】 |
该规则能够很好的提高易读性、高效性和安全性。在特殊情况下,能够不遵从,可是须要给出不遵从的理由。 |
【推荐】 |
该规则能够部分提高易读性、高效性和安全性。在大部分情况下,须要遵从。 |
【建议】 |
该规则仅仅是作为建议,代码作者能够依据自己推断来决定。 |
本“建议”中样例代码,使用不同底色表示代码是否存在问题:
表示代码存在问题。
表示一种能够修复存在问题代码的方式。
本建议将分为下面若干模块。我会依据工作中新的发现和认识以及朋友们的建议,不定期更新这些条例。并将更新历史记录在该文的末尾,以便大家查阅。
模块:
- 函数 《WindowsclientC/C++编程规范“建议”——函数》
- 指针 《WindowsclientC/C++编程规范“建议”——指针》
- 函数调用 《WindowsclientC/C++编程规范“建议”——函数调用》
- 表达式和运算 《WindowsclientC/C++编程规范“建议”——表达式和运算》
- 结构 《WindowsclientC/C++编程规范“建议”——结构》
- 宏 《WindowsclientC/C++编程规范“建议”——宏》
- 文件 《WindowsclientC/C++编程规范“建议”——文件》
- 变量和常量 《WindowsclientC/C++编程规范“建议”——变量和常量》
- 风格 《WindowsclientC/C++编程规范“建议”——风格》
更新历史:
时间 | 内容 | 备注 |
2014.07.18 | 录入“建议”各项 | 初稿 |
发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/118047.html原文链接:https://javaforall.cn
【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛
【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...