C宏文件命名约定



我想要一些关于命名仅包含宏的C文件的建议。

假设我正在实现struct My_obj。头文件应为:
my_obj.h

#ifndef MY_OBJ_H
#define MY_OBJ_H
struct My_obj {  
  /* ... */  
};  
void my_obj_do_something( struct My_obj *o );  
/* ... */  
#endif

现在,我有一堆宏来帮助处理这个结构一些其他文件可能想要使用它们,但它们与每个人都不相关,并且会弄乱标题。我把它们都放在另一个文件中:
my_obj.macross.h

#ifndef MY_OBJ_MACROS_H
#define MY_OBJ_MACROS_H
#define MY_OBJ_GENERATE_CODE_1_OF_MANY( OBJ ) 
/* ... */  
#endif  

源代码包括标头和宏文件,并使用它们生成实际代码:
my_obj.c

#include "my_obj.h"
#include "my_obj.macros.h"  
void my_obj_do_something( struct My_obj *o ) {
  MY_OBJ_GENERATE_CODE_X( o );
  /* ... */
}
/* ... */

我的问题是:这是一种经常出现的模式吗?这样的宏文件通常命名为什么?当我ls时,*.macros.h看起来有点笨重,所以我想知道是否有这样的约定。我遇到的最接近的是.def扩展名,但它在这里并不准确,因为该文件在包含时不会生成代码。有什么想法吗?

经常使用后缀"helper"、"utility"或"tools",如"my_obj_utility.h",或者在额外的目录"utilities"中更好。

您可以将文件命名为my_obj.macro。仅仅因为扩展不是.h并不意味着你不能#include它。

最新更新