C 头文件.h的写法

规范

1.系统中为每个功能模块创建一个.h头文件。
一个功能模块实现系统的一个方面功能，它可能由多个.c和.asm文件（汇编语言的源程序文件）来实现，为它创建一个.h头文件。

2.把一个模块的公共接口的函数原型放到.h文件中。这是public函数。
如：public.h

3.不要在.h头文件中放private函数或private宏, 把它们放到.c文件中，并用static修饰函数。

4.在.h头文件中，不要有执行的代码和变量声明，除非是inline函数（内联函数）。

5.在.h头文件中，不要暴露变量（variable），在.c中声明变量，如果外部需要使用这个变量，在.h中使用extern关键字来暴露变量。

6.在.h头文件中，不要暴露任何特定模块相关的数据结构的内部格式。
在.h头中，不要声明具体数据结构，如struct {…} foo，而是把它放到.c中，如果模块中需要这个结构输入或输出，在头中定义一个类型typedef struct foo module_type，这样客户模块可以创建它的实例。客户模块不必知道具体的foo结构的内部细节。