C++代码书写规范

(声明:本博客参考自简书网页https://www.jianshu.com/p/c1b6cf190e0b   以下内容是读后结合本人编程经验分享我对代码规范的理解和建议)

 一、前述

  代码作为程序员与计算机沟通的工具,其重要性不言而喻,但在漫漫的编程长路中,不可能一直是自主编程的,小组合作是必不可少的。因此,代码的规范性由此就显得十分重要,倘若你书写了不规范、给人以直观丑陋感,那么你的搭档就难以修改你书写的代码,甚至会拒绝合作。因此,作为代码初学者,掌握必要的代码规范知识是最基本的,本博客以c++为例子,举例分析代码规范。

 二、实例分析

1. 善用空格与空行

  ①正确使用空格和空行能给人以舒适感,而不是一连串紧密的代码给人的压迫感。

  函数名之后不要留空格,否则形参表示不明显

  如:int Fun1(int x)  //建议书写

    int Fun2 (int x)  //不建议书写

 

  ②if、 for、 while等判断和循环使用到的关键字之后应留一个空格再跟左括号‘ (’,以突出关键字。

  如: if (i = 0)

 

  ③定义变量的逗号之后要留空格。在for语句中的分号其后要留空格。

  如:

 for (i=0; i<5; i++)

      int a, b;

 

 

  ④赋值操作符、比较操作符、算术操作符、逻辑操作符、位域操作符,如“ =”、“ +=” “>=”、“ <=”、“ +”、“ *”、“ %”、“ &&”、“ <<”、 “ ^”等前后应当加空格。

  如: a = b; a += 10;

 

  ⑤在实现函数时,函数与函数之间应加空行,以方便区分两个不同的函数。

  如:

 void Fun1(int x)

  {

    //do something

  }

 

  void Fun2(double y)

  {

    //do something

  }

 

 

  PS: 过分使用空格也不是好的代码规范,应适当使用,如这样就不合适:for( int i = 0 ; i < 10 ; i ++ ) 这样滥用空格给人很空的感觉。

 

2. 注意每行代码的内容

  一行代码就做一件事情,不要将所有功能压缩至一行语句中。

  如: 

int main()

  {

    int num; double count; while (num <= 100) num++; return 0;  //不好的代码规范

  }

    int main()

  {

    int num;

    double count;

    while(num <= 100)

  {

    num++;

  }

    return 0;

  }

 

 

3. 变量、函数名命名规范

  ①变量,函数,文件命名最好采用英文单词或词组,不要使用拼音,或者无意义的a b c之类的,用英文单词或其缩写命名能起到在缺少注释的情况下能够给阅读者起提示作用。

  ②类名和函数名用大写字母开头能和普通变量区分开。

  个人喜爱使用的命名规范:双驼峰命名法:

  双驼峰命名法就是当变量名由多个单词组合而成时,第一个单词以小写字母开始,第二、三、四……N个单词的首字母大写。例如:myFirstWord,这样的变量名看上去就像骆驼峰一样此起彼伏,既美观,又能突出由词组命名的变量,减小冲突命名的可能性。

 

4. 适时添加注释

  有时候读代码会跟不上编程者的思维,若代码旁边没有注释,就难以理解其意思,因此适当添加注释不仅能够让自己回忆某行、某段代码的用处,还能方面阅读者理解。

  建议在每个函数名的后面添加对该函数的功能进行解释的注释,同时建议在main函数的每一个循环也最好添加注释,让阅读者明白循环的作用。

 

以上是我阅读参考博客的读后感和建议,希望自己能够好好记住这些规范,书写优美又实用的代码。

转载于:https://www.cnblogs.com/besthunterhj/p/11455022.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 华为C通用编程规范是为了提高华为公司内部C语言编程的规范化程度而制定的一系列规范。这些规范主要包括命名规范、缩进和格式规范、注释规范代码复用规范、错误处理规范等。 首先,命名规范要求使用有意义的变量名、函数名和常量名,避免使用缩或者过于简单的命名。此外,命名规范还要求符合统一的命名风格,比如驼峰命名法或下划线命名法。 其次,缩进和格式规范要求代码的缩进需要统一,一般为4个空格或者一个Tab键。同时,代码的格式要整齐,包括合理的函数和语句间隔、大括号的使用等。 注释规范要求对代码进行充分注释,包括函数的作用、参数的说明、返回值的说明等。注释的书写应该清晰明了,方便其他人理解代码的功能。 代码复用规范要求优先使用已经封装好的函数或者模块,避免重复编相似的代码,提高代码的可重用性和维护性。 最后,错误处理规范要求对于可能出现的错误情况,需要进行适当的错误处理。在代码中加入错误处理的相关代码,比如判断返回值、处理异常等,以保证代码的健壮性和稳定性。 通过遵守华为C通用编程规范,可以提高代码的可读性、可维护性和可重用性,减少程序出错的可能性,从而提高华为公司内部C语言编程的质量和效率。 ### 回答2: 华为C通用编程规范是一套适用于华为公司C语言开发的规范和准则。它旨在保证软件开发的质量、可维护性和可扩展性,提高代码的可读性和可靠性。 首先,华为C通用编程规范要求在编码时遵循一致的命名规则。变量、函数、宏等的命名要准确、具有可读性,并避免使用缩和无意义的命名。同时,对于具有特定作用域的变量,要求在其作用域结束后立即释放。 其次,规范还要求使用注释来解释代码的功能和实现细节。注释应该清晰明了,帮助其他开发人员理解代码的意图和思路。此外,规范还对注释的格式和位置进行了详细规定。 另外,华为C通用编程规范还对代码结构做出了要求。它鼓励使用模块化的方式组织代码,将功能相似的代码放在同一个模块中,提高代码的可重用性和可维护性。同时,规范还对代码缩进、空行、对齐等进行了规定,以确保代码的可读性。 此外,规范还强调了安全性和可靠性的考虑。它要求在编码过程中注意边界条件的检查,避免内存泄漏和缓冲区溢出等常见的安全问题。 总的来说,华为C通用编程规范是一套准则和规范,旨在提高华为公司C语言开发的质量和效率。通过规范的遵循,可以使代码更易于理解和维护,提高软件开发的质量和可靠性。 ### 回答3: 华为C通用编程规范是为了在华为C平台上编高质量、高效率的代码而制定的一系列规范和指南。下面是一些主要的规范内容: 1. 命名规范:变量、函数、常量、宏等命名应具有一定的描述性,尽量简洁明了。遵循驼峰命名法,并采用统一的命名风格。 2. 注释规范:在代码中添加适当的注释,用于解释代码的用途、实现方式等。注释应该清晰明了,避免使用过于简单或晦涩的注释。 3. 缩进和排版规范代码应该采用统一的缩进风格,以提高可读性。使用适当的空格和换行来使代码结构清晰明了。 4. 函数规范:函数应该具有明确的功能和单一的责任,参数的数量应控制在合理范围内。尽量避免使用全局变量,提倡使用局部变量。 5. 错误处理规范代码应该在可能出现错误的地方进行适当的错误处理,包括返回错误码、抛出异常等。同时,要注重错误信息的准确和可读性。 6. 内存管理规范:合理使用内存,尽量减少内存泄漏和内存溢出的可能。在不使用的内存对象上进行垃圾回收和释放。 7. 并发和多线程规范:在多线程环境下,要注意线程安全和竞态条件的问题,采用适当的同步机制来确保数据的一致性。 8. 异常处理规范:合理使用异常处理机制,捕获和处理可能出现的异常,保证程序的稳定性和健壮性。 通过遵守华为C通用编程规范,可以使开发者编出更加规范、易读、易维护的代码,提高开发效率,降低代码的bug率,提升软件的质量。此外,使用统一的编程规范还方便团队合作,提高代码的可维护性和可扩展性,有利于项目的整体进展。通过培养和强调良好的编程规范,可以更好地保障软件开发过程中的质量和效率。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值