C语言编码风格(四)——函数
来源:互联网 发布:腾讯视频 for mac 编辑:程序博客网 时间:2024/06/06 03:06
每个函数都应该设计得尽可能简单,简单的函数才容易维护。应遵循以下原则:
- 实现一个函数只是为了做好一件事情,不要把函数设计成用途广泛、面面俱到的,这样的函数肯定会超长,而且往往不可重用,维护困难。
- 函数内部的缩进层次不宜过多,一般以少于4层为宜。如果缩进层次太多就说明设计得太复杂了,应考虑分割成更小的函数(Helper Function)来调用。
- 函数不要写得太长,建议在24行的标准终端上不超过两屏,太长会造成阅读困难,如果一个函数超过两屏就应该考虑分割函数了。[CodingStyle]中特别说明,如果一个函数在概念上是简单的,只是长度很长,这倒没关系。例如函数由一个大的
switch
组成,其中有非常多的case
,这是可以的,因为各case
分支互不影响,整个函数的复杂度只等于其中一个case
的复杂度,这种情况很常见,例如TCP协议的状态机实现。 - 执行函数就是执行一个动作,函数名通常应包含动词,例如
get_current
、radix_tree_insert
。 - 比较重要的函数定义上侧必须加注释,说明此函数的功能、参数、返回值、错误码等。
- 另一种度量函数复杂度的办法是看有多少个局部变量,5到10个局部变量已经很多了,再多就很难维护了,应该考虑分割成多个函数。
注:[CodingStyle] Linux内核源代码目录下的Documentation/CodingStyle文件.
转自《linuxC编程 一站式学习》
转载请标明出处:萝卜根
- C语言编码风格(四)——函数
- C语言编码风格(二)——注释
- C语言编码风格(三)——标识符命名
- C语言编码风格(五)——indent工具
- C语言的编码风格-函数说明(6)
- C语言编码风格
- C语言编码风格
- C语言入门(19)——C语言的编码风格
- Android JNI(五)————JNI_JNI函数编码风格(C风格与C++风格)
- C语言编码风格(一)——缩进和空白
- Linux C语言编码风格
- Android:JNI函数编码风格(C风格与C++风格)
- C语言的编码风格-文件描述(1)
- C语言的编码风格-缩进(5)
- C语言的编码风格-变量命名(7)
- 致雅嵌入式工作室——C语言编码风格规范
- Linux下C语言编码的风格
- C语言编码风格和标准
- xml解析比较
- C语言编码风格(一)——缩进和空白
- C语言知识点总结
- C语言编码风格(二)——注释
- C语言编码风格(三)——标识符命名
- C语言编码风格(四)——函数
- C语言编码风格(五)——indent工具
- 大象Thinking in UML读书笔记一
- 漫漫找工路——百度、移动、华为等公司应聘经历总结
- 一位码农的人生自述(三十八)------惊喜
- 再谈Doxygen--一个开源文档生成工具
- linux 静态库 动态库常识
- document为空或不是对象
- 程序员编程标准之一模块和过程的设计