#pragma once vs. include guards [重复]

Question

我正在通过Implementation defined behavior control

还有与#pragma once相关的以下文字：

与标头保护不同，此编译指示不可能在多个文件中错误地使用相同的宏名称。

我不确定这意味着什么。谁能解释一下？

TIA

Answer 1

例子：

// src/featureA/thingy.h
#ifndef HEADER_GUARD_FOR_THINGY
#define HEADER_GUARD_FOR_THINGY
struct foo{};
#endif


// src/featureB/thingy.h
#ifndef HEADER_GUARD_FOR_THINGY
#define HEADER_GUARD_FOR_THINGY
struct bar{};
#endif


// src/file.cpp
#include "featureA/thingy.h"
#include "featureB/thingy.h" // oops, this file is removed by header guard
foo f;
bar b;

标头保护宏需要一丝不苟地保持其独特性。 #pragma once 会自动执行此操作。

为了公平起见，让我提一下缺点（也在链接页面中）：#pragma once 无法识别来自多个路径的同一个文件。对于具有特殊文件结构的项目，这可能是一个问题。示例：

// /usr/include/lib.h
#pragma once
struct foo{};


// src/ext/lib.h
#pragma once
struct foo{};


// src/headerA.h
#pragma once
#include <lib.h>

// src/headerB.h
#pragma once
#include "ext/lib.h"

// src/file.cpp
#include "headerA.h"
#include "headerB.h" // oops, lib.h is include twice
foo f;

Answer 2

假设您有一个头文件 File1.h。您创建了 File1.h：

#ifndef FILE_1_H
#define FILE_1_H

// Contents of File1.h

#endif

语言中没有任何内容可以阻止其他头文件使用相同的宏 FILE_1_H 作为包含保护。

1. 您使用的库中的头文件可能已经定义了它。
2. 由于复制和粘贴错误，您可以在自己的代码库中使用 File2.h 中的相同标头保护。

发生这种情况时，.cpp 文件中只有一个 .h 文件可以是 #included。在最好的情况下，您会得到可以解决问题的编译器错误。在最坏的情况下，您最终会使用错误的类型或函数，并且问题会在运行时显现出来。

由于这些原因，包含守卫并不健壮并且容易受到用户错误的影响。

但是，如果你的编译器支持它并且你使用

#pragma once

在你所有的头文件中，这样的错误都会被避免。

---

请注意使用

#pragma once 

有它自己的缺点。有关更多信息，请参阅以下内容：

Is #pragma once a safe include guard?
What are the dangers of using #pragma once?

Answer 3

包括警卫看起来像这样：

#ifndef SOME_NAME
#define SOME_NAME

// The header file contents

#endif

虽然有命名约定，但并没有强制执行宏（在这种情况下为SOME_NAME）将实际调用的内容。如果您尝试包含两个使用相同宏名称的头文件，编译器将看不到第二个文件的内容，因为该文件的 #ifndef ___ 将失败（该宏已在第一个文件中定义）。

#pragma once 不存在此问题。