-
函数设计的精髓:编写整洁函数,同时有效组织代码。
- 整洁函数要求:代码简单直接、不隐藏设计者的意图、用干净利落的抽象和直接了当的控制语句将函数组织起来。
- 代码的有效组织包括逻辑层和物理层两个方面。逻辑层,主要是把不同的函数通过某种联系组织起来,主要关注模块间的接口;物理层,函数用一种标准的方式组织起来。
函数编程的原则
- 1 一个函数仅完成一个功能。
- 2重复代码应该尽可能提炼成函数。
函数编程的规则
- 1 避免函数过长,新增函数不超过50行
- 2 避免函数的代码块嵌套过深,新增函数的代码块嵌套不超过4层
- 3 可重入函数应避免使用共享变量,若需要使用,则硬通过互斥手段(关中断、信号量)对其加以保护。 可重入函数是指被多个任务并发调入的函数,调用重入函数时可申请信号量操作和释放信号量操作。
- 4 对参数的合法性检查,由调用者负责还是由接口函数负责,应由项目组/模块内应统一规定,缺省由调用者负责。
- 5 对函数的错误返回要全面处理。
- 6 设计高扇入,合理扇出(小于7)的函数。
- 7 放弃代码(没有被调用的函数和变量)要及时清除
函数编程的建议
- 1 函数不变参数使用const.
- 2 函数应避免使用全局变量、静态局部变量和I/o操作,不可避免的地方应集中使用。
- 3 检查函数所有非参数输入的有效性,如数据文件、公共变量等。
- 4 函数的参数个数不超过5个
- 5 除打印类函数外,不用使用可变长参函数。
- 6 在源文件范围内声明和定义的所有函数,除非外部可见,否则应该增加static关键字。
转载自原文链接, 如需删除请联系管理员。
原文链接:C语言编程规范(函数),转载请注明来源!