写好C语言的头文件

C语言头文件的一些规则： 

（1）每个头文件的首部应该加上描述信息

/**//**************************************************************
function:
description:
arguments:
return value:
calls:
globals:
****************************************************************/

（2）整个文件的其余代码应该包含在Guard Define内

#ifndef __MAIN_H__
#define __MAIN_H__

#endif

（3）给C++引用的头文件还应该有extern "C"标示

#ifdef __cplusplus
extern "C"
...{
#endif

//codes

#ifdef __cplusplus
}
#endif

（4）将数据结构隐藏在头文件中

typedef struct file_opt file_opt;

（5）在函数声明时区分函数的用途

#define CAM_API extern

CAM_API unsigned char *get_image(int fd); //被其它函数调用
void show_image(char *img); //被用户调用

（6）在定义宏时，使用括号

#define MAX(a,b) ( (a)>(b) ? (a) : (b) )