11.5 一个头文件可以包含另一头文件吗？

这是个风格问题, 因此有不少的争论。 很多人认为 ``嵌套包含文件" 应该避免: 盛名远播的 ``印第安山风格指南"(Indian Hill Style Guide, 参见问题 17.7)  对此嗤之以鼻; 它让相关定义更难找到; 如果一个文件被包含了两次, 它会导致重复定义错误; 同时他会令 makefile 的人工维护十分困难。 另一方面, 它使模块化使用头文件 成为一种可能 (一个头文件可以包含它所需要的一切, 而不是让每个源文件都包含 需要的头文件); 类似 grep 的工具 (或 tags 文件) 使搜索定义十分容易, 无论 它在哪里; 一种流行的头文件定义技巧是:

    #ifndef HFILENAME_USED
    #define HFILENAME_USED
    ... 头文件内容 ...
    #endif

每一个头文件都使用了一个独一无二的宏名。这令头文件可自我识别，以便 可以安全的多次包含; 而自动 Makefile 维护工具 (无论如何, 在大型项目中都 是必不可少的) 可以很容易的处理嵌套包含文件的依赖问题。 参见问题 17.8。

参考资料: [Rationale, Sec. 4.1.2]。