C语言书写法律规范指南第 1 章文件结构每个C程序通常分为两个文件
一个文件用于保存程序的声明(declaration),称为头文件
另一个文件用于保存程序的实现(implementation),称为定义(definition)文件
C程序的头文件以“
h”为后缀,C程序的定义文件以“
1 版权和版本的声明版权和版本的声明位于头文件和定义文件的开头(参见示例1—1),主要内容有:(1)版权信息
(2)文件名称,标识符,摘要
(3)当前版本号,作者/修改者,完成日期
(4)版本历史信息
/**Copyright(c)2001,吉林大学物理学院无线电*Allrightsreserved
**文件名称:filename
h*文件标识: *摘要:简要描述本文件的内容**当前版本:1
1*作者:输入作者(或修改者)名字*完成日期:2025年7月20日**取代版本:1
0*原作者:输入原作者(或修改者)名字*完成日期:2025年5月10日*/示例1-1版权和版本的声明1
2 头文件的结构头文件由三部分内容组成:(1)头文件开头处的版权和版本声明(参见示例1-1)
(2)预处理块
(3)函数和类结构声明等
假设头文件名称为 SCL_SPI
h,头文件的结构参见示例1-2
【规则1-2-1】为了防止头文件被重复引用,应当用 #ifndef/#define/#endif结构产生预处理块
【规则1—2—2】用 #include 格式来引用标准库的头文件(编译器将从标准库目录开始搜索)
【规则1—2-3】用 #include “filename
h”格式来引用非标准库的头文件(编译器将从用户的工作目录开始搜索)
【规则1—2-4】 #include 后面使用TAB键控制排版
【规则1-2-5】头文件中只存放“声明"而不存放“定义”【规则1-2—6】全局变量在头文件中声明,在