用户提供接口,用户只要包含相应的头文件就可以使用在这个头文件中暴露的接口。所有的头文件都建议参考以下的规则:
1. 头文件中不能有可执行代码,也不能有数据的定义,只能有宏、类型(typedef,struct,union,menu),数据和函数的声明。
例如以下的代码可以包含在头文件里:
#define NAMESTRING “name”
typedef unsigned long word;
menu{ flag1,flag2};
typedef struct
{
int x;
int y;
}Piont;
extent Fun(void);
extent int a;
#define NAMESTRING “name”
typedef unsigned long word;
menu{ flag1,flag2};
typedef struct
{
int x;
int y;
}Piont;
extent Fun(void);
extent int a;全局变量和函数的定义不能出现在*.h文件里。例如下面的代码不能包含在头文件:
int a;
void Fun1(void)
{
a++;
}
int a;
void Fun1(void)
{
a++;
}
2. 头文件中不能包本地数据(模块自己使用的数据或函数,不被其他模块使用)。
这一点相当于面向对象程序设计里的私有成员,即只有模块自己使用的函数,数据,不要用extern在头文件里声明,只有模块自己使用的宏,常量,类型也不要在头文件里声明,应该在自己的*.c文件里声明。
3. 含一些需要使用的声明。在头文件里声明外部需要使用的数据,函数,宏,类型。
4. 防止被重复包含。使用下面的宏防止一个头文件被重复包含。
#ifndef MY_INCLUDE_H
#define MY_INCLUDE_H
<头文件内容>
#endif