§5 编写高质量的单片机C程序
高质量的单片机C程序代码运行效率高、可读性和可维护性强。在编写小型的单片机程序时,代码质量的重要性可能不是很明显。但如果要编写较大规模的程序,特别是多人合作编写程序时,这一点就变得十分重要了。本章内容以林锐的《高质量C++/C编程指南》为蓝本,针对单片机编程的实际各部进行了大量删节和改写。
5.1 文件结构
每个单片机C程序通常分为两种文件。一个文件用于保存程序的声明(declaration),称为头文件。另一个文件用于保存程序的实现(implementation),称为定义(definition)文件。程序的头文件以“.h”为后缀,定义文件以“.c”为后缀。 5.1.1 版权和版本的声明
版权和版本的声明位于头文件和定义文件的开头(参见示例5.1),主要内容有: (1)版权信息。
(2)文件名称,标识符,摘要。
(3)当前版本号,作者/修改者,完成日期。 (4)版本历史信息。
示例5.1 版权和版本的声明
5.1.2 头文件的结构
头文件由三部分内容组成:
(1)头文件开头处的版权和版本声明(参见示例5.1)。 (2)预处理块。 (3)函数声明等。
假设头文件名称为 graphics.h,头文件的结构参见示例5.2。
【规则5-1-2-1】为了防止头文件被重复引用,应当用ifndef/define/endif结构产生预处理块。
【规则5-1-2-2】用 #include 格式来引用标准库的头文件(编译器将从标准