【基础实战01】C++基础之#pragma once的理解

已于 2024-10-17 20:56:43 修改
阅读量1.3k 收藏 7
点赞数 11
分类专栏： c++篇 文章标签： c++ 开发语言 visual studio
于 2024-08-03 13:35:45 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_52677672/article/details/140886829
版权

1. 什么是#pragma once

在C++中，#pragma once是用于防止头文件被多次包含的预处理指令，与传统的包含保护（#ifndef、#define、#endif）相比，它更加简洁高效。

2. 传统方法与#pragma once的使用示例对比

（1）传统方法：

// Teacher.h
#ifndef TEACHER_H
#define TEACHER_H

#include "Student.h"

class Student;  // 前向声明

class Teacher {
public:
    void teach();
    Student* student;
};

#endif // TEACHER_H

在传统方法中，使用宏定义来防止头文件被多次包含。这个方法需要手动定义和检查宏，代码稍显繁琐。

（2）使用#pragma once：

// Teacher.h
#pragma once
#include "Student.h"

class Student;  // 前向声明

class Teacher {
public:
    void teach();
    Student* student;
};

#pragma once通过编译器确保头文件只被编译一次，省去了宏定义和检查的步骤，更加简洁明了。

3. 传统方法与 #pragma once 的特点

3.1 传统方法（包含保护宏）

特点:

  1. 兼容性：

    • 使用条件编译指令 #ifndef、#define 和 #endif，几乎所有的C/C++编译器都支持。
    • 跨平台兼容，确保代码在不同编译器和操作系统上都能正常工作。

  2. 通用性：

    • 适用于所有C/C++项目，特别是需要跨平台兼容的项目。

  3. 模板：

    • 代码模板如下：

      #ifndef HEADER_NAME_H
#define HEADER_NAME_H

// 头文件内容：声明，定义语句...

#endif // HEADER_NAME_H

  4. 维护成本：

    • 每个头文件需要定义唯一的宏名称，可能会增加维护成本，特别是在大型项目中。

3.2 #pragma once

特点:

  1. 简洁性：

    • 只需在头文件顶部添加 #pragma once，不需要定义和检查宏。
    • 代码更简洁，减少了潜在的错误。

  2. 性能：

    • 编译器可以更高效地处理头文件，减少重复编译的开销。

  3. 支持情况：

    • 大多数现代编译器（如GCC、Clang、MSVC）都支持。
    • 某些老旧或特殊编译器可能不支持。

  4. 模板：

    • 代码模板如下：

      #pragma once

// 头文件内容

3.3 对比总结

  • 兼容性：传统方法在任何编译器上都能工作，而 #pragma once 依赖于编译器的支持。
  • 简洁性：#pragma once 更加简洁，减少了代码量和出错的可能性。
  • 维护成本：#pragma once 维护成本较低，不需要管理多个宏名称。
  • 性能：#pragma once 可能具有更好的编译性能，因为编译器可以优化处理。

在现代开发环境中，#pragma once 通常是首选方法，但在需要跨平台兼容的项目中，传统方法仍然是一个可靠的选择。

4. 代码实战

在使用VS2022创建头文件时，大家会发现，VS2022会默认在新建的头文件中的第一行生成#pragma once

（1）使用 #pragma once 的示例

以下是一个简单的C++项目示例，展示如何使用 #pragma once 来防止头文件的重复包含。

文件结构

project/
│
├── main.cpp
├── Teacher.h
└── Student.h

头文件 Teacher.h

// Teacher.h
#pragma once
#include "Student.h"

class Student;  // 前向声明

class Teacher {
public:
    void teach();
    Student* student;
};

头文件 Student.h

// Student.h
#pragma once
#include "Teacher.h"

class Teacher;  // 前向声明

class Student {
public:
    void study();
    Teacher* teacher;
};

源文件 main.cpp

// main.cpp
#include <iostream>
#include "Teacher.h"
#include "Student.h"

void Teacher::teach() {
    std::cout << "Teaching a student." << std::endl;
}

void Student::study() {
    std::cout << "Studying with a teacher." << std::endl;
}

int main() {
    Teacher teacher;
    Student student;

    teacher.student = &student;
    student.teacher = &teacher;

    teacher.teach();
    student.study();

    return 0;
}

详细解释

  1. 文件结构：
    • main.cpp 是程序的入口点。
    • Teacher.h 和 Student.h 是两个头文件，分别定义了 Teacher 和 Student 类。
  2. 前向声明：
    • 在 Teacher.h 和 Student.h 中，都有对另一个类的前向声明，避免了循环依赖的问题。
  3. #pragma once：
    • 每个头文件顶部使用 #pragma once，确保头文件只被编译一次，防止重复包含。

（2）使用传统方法防止头文件重复包含的示例

文件结构

project/
│
├── main.cpp
├── Teacher.h
└── Student.h

头文件 Teacher.h

// Teacher.h
#ifndef TEACHER_H
#define TEACHER_H

#include "Student.h"

class Student;  // 前向声明

class Teacher {
public:
    void teach();
    Student* student;
};

#endif // TEACHER_H

头文件 Student.h

// Student.h
#ifndef STUDENT_H
#define STUDENT_H

#include "Teacher.h"

class Teacher;  // 前向声明

class Student {
public:
    void study();
    Teacher* teacher;
};

#endif // STUDENT_H

源文件 main.cpp

// main.cpp
#include <iostream>
#include "Teacher.h"
#include "Student.h"

void Teacher::teach() {
    std::cout << "Teaching a student." << std::endl;
}

void Student::study() {
    std::cout << "Studying with a teacher." << std::endl;
}

int main() {
    Teacher teacher;
    Student student;

    teacher.student = &student;
    student.teacher = &teacher;

    teacher.teach();
    student.study();

    return 0;
}

详细解释

  1. 文件结构：
    • main.cpp 是程序的入口点。
    • Teacher.h 和 Student.h 是两个头文件，分别定义了 Teacher 和 Student 类。
  2. 前向声明：
    • 在 Teacher.h 和 Student.h 中，都有对另一个类的前向声明，避免了循环依赖的问题。
  3. 包含保护：
    • 每个头文件顶部使用 #ifndef、#define 和 #endif，确保头文件只被编译一次，防止重复包含。

写在最后

通过本篇博客，我们探讨了C++中#pragma once与传统包含保护方法的使用和特点。#pragma once提供了更为简洁和高效的方式来防止头文件的重复包含，而传统方法则具有更广泛的兼容性和通用性。

在实际项目中，选择哪种方法取决于项目的需求和目标编译器的支持情况。在现代开发环境中，#pragma once通常是首选方法，但在需要跨平台兼容的项目中，传统方法仍然是一个可靠的选择。

学习编程不仅仅是掌握语法和使用工具，更重要的是理解背后的思想和原理。希望通过我的博客，能够帮助你更好地理解和应用这些技术，不断提升自己的编程能力。在实际项目中多实践、多思考，将理论与实践相结合，才能真正掌握这些编程技巧。祝你在编程的道路上不断进步！

转载请标明出处
如果还有问题，欢迎在评论区留言或私信
作者：BQ
主页：bqcode.blog.csdn.net
QQ群：958124241
Learn Together！

BQ-Code
关注
专栏目录
#pragma once用法总结
程序猿老樊的博客
08-27 5万+
1.#pragmaonce这个宏有什么作用？ 为了避免同一个头文件被包含（include）多次，C/C++中有两种宏实现方式：一种是#ifndef方式；另一种是#pragma once方式。 在能够支持这两种方式的编译器上，二者并没有太大的区别。但两者仍然有一些细微的区别。 2.两者的使用方式有何区别？ 示例代码如下： 复制代码  //方式一：  #ifndef  __SOMEFIL
C/C++ 中的 #pragma once 作用是什么？
编程与实战的博客
02-17 3万+
击上方“C语言与CPP编程”，选择“关注/置顶/星标公众号”干货福利，第一时间送达！1、#pragma once有什么作用？为了避免同一个头文件被包含（include）多次，C/C++中有...
C/C++中#pragma once的使用
热门推荐
网络资源是无限的
12-02 4万+
C/C++中#pragma once的使用
#pragma once
最新发布
qq_41327049的博客
09-19 131
使用#pragma once可以简化代码，因为它避免了使用传统的头文件保护（header guards）方法，即使用#ifndef、#define和#endif来防止头文件被重复包含。然而，需要注意的是，#pragma once不是C++标准的一部分，但在实践中，它的使用是安全的，因为几乎所有现代编译器都支持它。它的作用是防止头文件被重复包含（即多次包含同一个头文件）。当编译器遇到#pragma once时，它会确保该头文件在编译过程中只被包含一次，即使它在多个源文件中被#include了多次。
#pragma once与 #ifndef的区别
u012947821的专栏
03-26 535
1概述编辑 这是一个比较常用的C/C++杂注，只要在头文件的最开始加入这条杂注，就能够保证头文件只被编译一次。 #pragma once是编译器相关的，就是说即使这个编译系统上有效，但在其他编译系统也不一定可以，不过现在基本上已经是每个编译器都有这个杂注了。 #ifndef，#define，#endif是C/C++语言中的宏定义，通过宏定义避免文件多次编译。所以在所有支持C++语
C++（一）#pragma once用法
qq_43907537的博客
08-11 3784
C++（一）#pragma once用法 用法 **C/C++**中，在使用预编译指令#include的时候，为了防止重复引用造成二义性 #ifndef #ifndef _CODE_BLOCK #define _CODE_BLOCK // code #endif// _CODE_BLOCK 作用是一样的 区别 #ifndef方式是C/C++语言的标准支持，也是比较常用的方式，#ifndef的方式依赖于自定义的宏名（例中的_CODE_BLOCK）不能冲突，它不光可以保证同一份文件不会被包含两次
c++#pragma once
朱峰的专栏
05-25 877
http://blog.csdn.net/zlhy_/article/details/8192580
[C++] #pragma once
学习笔记
05-23 233
看到一段代码使用了 #pragma once #if !defined(STRING_MANIPULATOR_H_INCLUDED) #define STRING_MANIPULATOR_H_INCLUDED #if _MSC_VER &amp;amp;amp;gt; 1000 #pragma once #endif // _MSC_VER &amp;amp;amp;gt; 1000 #endif // !defined(AFX_ST...
发现在MSVS2022中”#pragma once“不起作用
**My Coding Family**
09-12 914
如上问题有的来自我自身项目开发，有的收集网站，有的来自读者…如有侵权，立马删除。再者，针对此专栏中部分问题及其问题的解答思路或步骤等，存在少部分搜集于全网社区及人工智能问答等渠道，若最后实在是没能帮助到你，还望见谅！并非所有的解答都能解决每个人的问题，在此希望屏幕前的你能够给予宝贵的理解，而不是立刻指责或者抱怨！如果你有更优解，那建议你出教程写方案，一同学习！共同进步。ok，以上就是我这期的Bug修复内容啦，如果还想查找更多解决方案，你可以看看我专门收集Bug及提供解决方案的专栏。
#ifndef 和 #pragma once
weixin_29630121的博客
08-04 62
为了避免同一个文件被include多次，C/C++中有两种方式，一种是#ifndef方式，一种是#pragma once方式, 二者在实现上有一些区别. #ifndef 方式 #ifndef __SOMEFILE_H__ #define __SOMEFILE_H__ ... ... // 声明、定义语句 #endif 优点 受C/C++语言标准支持。 缺点 如果不同头文件中的宏名会导致你看到头文件明明存在，编译器却硬说找不到声明的状况. 编译器每次都需要打开头文件
C++实战贪食蛇，简单易理解 2021-08-16
Cukor丘克的博客
08-16 214
C++实战贪食蛇 文章目录C++实战贪食蛇一、总体思路1.1 开发环境1.2 插件1.3 自定义的头文件和源文件1.3.1 头文件1.3.2源文件二、细节内容三、测试源代码四、效果展示 学了那么久的C++语法，没有点小项目来玩玩的话是会感觉挺枯燥的。这篇文章记录C++的贪食蛇，简单易懂。 首先使用的是多文件的写法，代码开起来不会太多。直接开始吧。 一、总体思路 把需要的蛇、食物、坐标都封装成类，然后在主函数中去调用。蛇的形状就用多个矩形连起来来代替。食物是随机在界面中产生，食物也是用矩形来代替。食物中有一个
C++类和对象实战之分文件编写点和圆的关系（详解）
微凉秋意的博客
05-17 489
🎉每一个不曾起舞的日子，都是对生命的辜负🎉 上一期把C++类和对象的封装讲完了，并且留下了一个判断两个立方体是否相等的案例，但是那么多知识点，仅仅一个案例是不够的，所以再来一个分文件编写点圆关系的案例；创建圆类和点类，圆类包含点类，算是一个嵌套吧，顺便复习一下分文件编写的方法，开整！ 创建圆心类 point.h #pragma once #include<iostream> using namespace std; //创建圆心类 class Point { public: void
c++学习笔记-#pragma once
愤怒的小江哥-移动游戏专栏
02-28 746
/** #pragma 预处理宏的一般格式：#pragma one one是参数 **/ /** (1)#pragma message("message") 当编译器遇到这条指令时，它会在编译输出窗口中将message打印出来。常用于宏条件条件判断中使用，这样就知道自己的宏条件是否正确。例如： */ #ifdef _USRDLL #pragme message("_USRDLL avai...
C++之#pragma once实例总结(二百四十七)
Android系统攻城狮
10-26 413
本篇目的：理解C++之#pragma once用法总结。#pragma once是一种预处理指令，用于告诉编译器在编译过程中只包含一次特定的头文件。它是一种非标准的C++语言扩展，主要用于避免头文件被重复包含。在C++中，头文件经常被用来包含代码的声明或定义，然后在其他源文件中进行引用。当多个源文件都包含同一个头文件时，如果没有适当的预处理指令，会导致重复定义和编译错误。
C++ #pragma once用法总结
qq_42707243的博客
10-28 667
#pragma once用法总结 1.#pragmaonce这个宏有什么作用？ 为了避免同一个头文件被包含（include）多次，C/C++中有两种宏实现方式：一种是#ifndef方式；另一种是#pragma once方式。 在能够支持这两种方式的编译器上，二者并没有太大的区别。但两者仍然有一些细微的区别。 2.两者的使用方式有何区别？ 示例代码如下： 方式一： #ifndef__SOMEFILE_H__ #define __SOMEFILE_H__ ... ... //...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

BQ-Code

你的鼓励将是我创作的最大动力！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值