C++ 中的 Pragma Once
本文首先概述作为预处理器指令的 pragma once 以及如何使用它的简单示例。在此之后，我们将介绍 pragma once 关于其在 C 和 C++ 中的支持的一些特定属性，最后，我们将包含一个更全面的示例，说明如何使用它以及它如何优于其他替代方案。
C++ 中的 Pragma once
pragma once 在 C 和 C++ 中用作预处理器指令。预处理器指令是单行代码，不构成程序，而是由预处理器读取。
预处理器在编译代码之前分析这些。预处理器也不希望在这些指令的末尾有分号。
因此，要将 pragma once 指令添加到你的代码中，请将以下内容添加到文件顶部。
#pragma once
pragma once 本身是非标准的。这意味着一些编译器将不支持它，并且由于其复杂的实现，它可能并不总是可靠的。
但是，它非常普遍地得到支持；因此在大多数情况下，使用 pragma once 应该不是问题。它的目的很简单：它确保当前源文件（正在写入指令的文件）在编译中只包含一次。
这项工作也可以使用 include guards 来完成。我们将在举例说明如何使用 pragma once 之后讨论差异。
pragma once 主要用于定义类时。在下面的例子中，我们将定义两个类：Structure 和 Room。
Room 类将继承自 Structure 类。
// This contains the code for the Structure class
// Save this as Structure.h
#pragma once
#include <iostream>#include <string>using namespace std;
class Structure
{
string struc_name;
int id;
public:
void setVals()
{
struc_name = "Example Name";
id = 1;
}
void printVals()
{
cout << "Name is: " << struc_name << " and id is: " << id << endl;
}
};
我们现在将定义 Room 类。
// Save this as Room.h
#pragma once
#include "Structure.h"class Room {
Structure example;
public:
void initRoom() {
example.setVals();
}
void getRoom() {
example.printVals();
}
};
我们现在可以定义一个使用上述对象的 main 函数。
// save this in a main.cpp file
#include "Structure.h"#include "Room.h"#include <iostream>using namespace std;
int main()
{
Room testRoom;
testRoom.initRoom();
testRoom.getRoom();
return 0;
}
在上面的示例中，如果我们运行代码，我们会得到 Name is: Example Name and id is: 1 作为输出，这正是我们所期望的。但是，如果我们删除 pragma once，我们会收到以下错误。
In file included from Room.h:3,
from main.cpp:2:
Structure.h:8:7: error: redefinition of 'class Structure'
8 | class Structure
| ^~~~~~~~~
In file included from main.cpp:1:
Structure.h:8:7: note: previous definition of 'class Structure'
8 | class Structure
| ^~~~~~~~~
Structure 类定义了两次。使用 pragma once，我们可以确保它只被读取一次。
另一种方法是使用标识符。在上述示例的上下文中，我们可以按照下面的定义进行操作。
#ifndef STRUCTURE
#define STRUCTURE
class Structure {
// Some sample code here
};
#endif
在上面的示例中，STRUCTURE 可以替换为任何内容。但是，我们通常将名称保留为与类名称相对应的名称。
但是，这里可能存在问题。首先，它更冗长，需要手动决策，并且编译器无法防止程序员在项目的其他地方意外使用宏名称。
编译器通常针对 pragma once 进行优化，以提高编译速度。
