c++ - 哪些类型的头文件不应该受到多重包含的保护？

Question

我阅读了 dcmtk 源代码，并在ofstdinc.h中找到了一条注释：

// this file is not and should not be protected against multiple inclusion

哪些类型的头文件不应该受到多重包含的保护？

Answer 1

预处理器元编程。也就是说，使用包含的文件作为一种执行某些任务的编译时函数。该函数的参数是宏。例如，您链接的文件有一个如下所示的部分：

// define INCLUDE_STACK to include "ofstack.h"
#ifdef INCLUDE_STACK
#include "dcmtk/ofstd/ofstack.h"
#endif

因此，如果我想包含"ofstack.h"，我会这样做：

#define INCLUDE_STACK
#include "ofstdinc.h"
#undef INCLUDE_STACK

现在，想象一下，有人想使用标题的这个特定部分：

// define INCLUDE_STRING to include "ofstring.h"
#ifdef INCLUDE_STRING
#include "dcmtk/ofstd/ofstring.h"
#endif

所以他们做了以下事情：

#define INCLUDE_STRING
#include "ofstdinc.h"
#undef INCLUDE_STRING

如果"ofstdinc.h"有包括警卫，它不会被包括在内。

Answer 2

一个示例是希望您定义宏的头文件。m.h考虑一个标题

M( foo, "foo" )
M( bar, "bar" )
M( baz, "baz" )

这可以在其他一些标题中使用，如下所示：

#ifndef OTHER_H
#define OTHER_H

namespace other
{
    enum class my_enum
    {
#define M( k, v ) k,
#include "m.h"
#undef M
    };

    void register_my_enum();
}

#endif

在其他一些文件中（可能是实现）：

#include "other.h"

namespace other
{
    template< typename E >
    void register_enum_string( E e, const char* s ) { ... }

    void register_my_enum()
    {
#define M( k, v ) register_enum_string( k, v );
#include "m.h"
#undef M
    }
}

Answer 3

您几乎总是希望防止多重包含。您唯一不想这样做的情况是，如果您正在使用 C 宏做一些花哨的事情，因此您希望有多个包含来获得您想要的代码生成（没有这个临时的例子）。