WindowsclientC/C++编程规范“建议”——前言

WindowsclientC/C++编程规范“建议”——前言

大家好,又见面了,我是全栈君,祝每个程序员都可以多学几门语言。

前言

        工作中接触了非常多编程规范。当中最有意思的是,公司近期公布了一版C/C++编程规范,然后我看到该规范的最后一段时,有这么一句:“该规范不适用于Windows平台开发”。看来这份规范是由做其它平台开发的同学制定的。那么做Windows开发的人都去哪儿了?后来因为工作须要,项目组须要我制定一份编程规范。这也是我这系列博客的由来。(转载请指明出于breaksoftware的csdn博客)

        说到“规范“”,可能没多少人喜欢这种东西。相信非常多project师和我一样,都喜欢互联网的一些特质:自由、兼容并包。己所不欲勿施于人,所以我制定该“规范”时,也是抱着开放的态度——在”规范“之后加了”建议“二字。之后,我都会统称这些条例为“建议”。

        假如说指定“规范”是easy的(事实上也不easy),那么最难的是让人遵从。一般假设我们想遵从什么,肯定要先想好我们为什么要遵从,我们遵从之有什么优点,能够给我们带来什么?相同我也是按着这个思维去制定这种“建议”,我将会从代码的可读性、可维护性、健壮性等角度,思考和编制该“建议”。希望这些“建议”能够协助大家写出更易读、更健壮、更好看的代码。

        本“建议”条例分为下面若干等级:

【必须】

编码必须遵从。

【要求】

该规则能够很好的提高易读性、高效性和安全性。在特殊情况下,能够不遵从,可是须要给出不遵从的理由。

【推荐】

该规则能够部分提高易读性、高效性和安全性。在大部分情况下,须要遵从。

【建议】

该规则仅仅是作为建议,代码作者能够依据自己推断来决定。

        本“建议”中样例代码,使用不同底色表示代码是否存在问题:

        快哭了表示代码存在问题。

        微笑表示一种能够修复存在问题代码的方式。

        本建议将分为下面若干模块。我会依据工作中新的发现和认识以及朋友们的建议,不定期更新这些条例。并将更新历史记录在该文的末尾,以便大家查阅。

        模块:

  1. 函数                     《WindowsclientC/C++编程规范“建议”——函数》
  2. 指针                     《WindowsclientC/C++编程规范“建议”——指针》 
  3. 函数调用             《WindowsclientC/C++编程规范“建议”——函数调用》
  4. 表达式和运算     《WindowsclientC/C++编程规范“建议”——表达式和运算》
  5. 结构                     《WindowsclientC/C++编程规范“建议”——结构》
  6. 宏                         《WindowsclientC/C++编程规范“建议”——宏》
  7. 文件                     《WindowsclientC/C++编程规范“建议”——文件》
  8. 变量和常量         《WindowsclientC/C++编程规范“建议”——变量和常量》
  9. 风格                     《WindowsclientC/C++编程规范“建议”——风格》

        更新历史:

时间 内容 备注
2014.07.18 录入“建议”各项 初稿
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/118047.html原文链接:https://javaforall.net

(0)
全栈程序员-站长的头像全栈程序员-站长


相关推荐

  • 关于数组元素(ArrayPlug)的增减使用,逻辑索引和物理索引,MArrayDataBuilder

    关于数组元素(ArrayPlug)的增减使用,逻辑索引和物理索引,MArrayDataBuilder

    2021年8月28日
    59
  • vue 调用子组件方法失败_Vue子组件调用父组件的方法及常见问题「建议收藏」

    vue 调用子组件方法失败_Vue子组件调用父组件的方法及常见问题「建议收藏」1.子组件内不允许直接修改父组件传过来的参数。错误实例:子组件代码直接对data参数进行修改,则会提示错误。vue.runtime.esm.js?2b0e:619[Vuewarn]:Avoidmutatingapropdirectlysincethevaluewillbeoverwrittenwhenevertheparentcomponentre-render…

    2022年10月2日
    3
  • 理解面向对象的语言特点_面向对象的理解并举例

    理解面向对象的语言特点_面向对象的理解并举例前言:我们学习的javascript语言是一门面向对象的语言,所以这一概念我们需要理解与认识!下面是理解性的理论内容,不需要记忆,理解与思考我们的学习才能站在更高的视角!一、认识:面向对象是当今主

    2022年8月2日
    6
  • 硬核!用Mac Mini翻新了一台12年前的电脑

    硬核!用Mac Mini翻新了一台12年前的电脑本文转载自差评君有这么一位差友,不知道从哪儿加到了托尼的微信,都还没打招呼呢,上来就向我展现了他最近的硬核杰作。他将M1款的MacMini塞进了09年款27寸iMac,并把详细过程一股脑发给了我。尽管不清楚这样做有什么意义,但确实是做的很硬核,手法也相当专业,简单来说,他愣是把一台新电脑,塞进了一台老电脑。。。整理了一下他发过来的内容,大致弄清了这事儿的前因后果。把M1款的Macmini,塞进了09年iMac的想法,是他在看到了油管上有一位叫L…

    2022年5月30日
    88
  • 不一般的Cover Letter

    不一般的Cover Letter上篇文章的coverletter能罩得住大部分的期刊,但是你也知道,这个世界总是有例外的。上个月写了一篇文章,投稿的时候才记起来忘记了写coverletter,就顺手把那个模板找出来,填上空,加上几句描述性的语句,就把文章投出去了。过了两天,编辑发了一封邮件,说这个期刊最近改变了它的scope跟coverage,还更改了研究方向的类别。他希望我们能给出一个合理的理由来说明,投的文章适合期刊哪…

    2022年6月1日
    31
  • 图解phpstorm常用快捷键

    图解phpstorm常用快捷键

    2021年9月18日
    49

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号