C语言编程规范(函数)

• 函数设计的精髓：编写整洁函数，同时有效组织代码。

• 整洁函数要求：代码简单直接、不隐藏设计者的意图、用干净利落的抽象和直接了当的控制语句将函数组织起来。
• 代码的有效组织包括逻辑层和物理层两个方面。逻辑层，主要是把不同的函数通过某种联系组织起来，主要关注模块间的接口；物理层，函数用一种标准的方式组织起来。

函数编程的原则

• 1 一个函数仅完成一个功能。
• 2重复代码应该尽可能提炼成函数。

函数编程的规则

• 1 避免函数过长，新增函数不超过50行
• 2 避免函数的代码块嵌套过深，新增函数的代码块嵌套不超过4层
• 3 可重入函数应避免使用共享变量，若需要使用，则硬通过互斥手段（关中断、信号量）对其加以保护。 可重入函数是指被多个任务并发调入的函数，调用重入函数时可申请信号量操作和释放信号量操作。
• 4 对参数的合法性检查，由调用者负责还是由接口函数负责，应由项目组/模块内应统一规定，缺省由调用者负责。
• 5 对函数的错误返回要全面处理。
• 6 设计高扇入，合理扇出(小于7)的函数。
• 7 放弃代码（没有被调用的函数和变量）要及时清除</