C语言 #pragma once - C语言零基础入门教程

àì夳堔傛蜴生んèń 2022-09-10 06:28 125阅读 0赞

*  一.\#pragmaonce 宏简介
 *  二.\#pragmaonce 与 \#ifndef 使用
    
     *  1.\#ifndef
     *  2.\#pragmaonce
 *  三.\#pragmaonce 与 \#ifndef 区别
    
     *  1.\#ifndef
     *  2.\#pragma once
 *  四.\#pragmaonce 与 \#ifndef 联系
 *  五.猜你喜欢

> 零基础 C/C++ 学习路线推荐 : [C/C++ 学习目录][C_C_] >> [C 语言基础入门][C]

## **一.\#pragmaonce 宏简介** ##

> **为了避免同一个头文件被包含（include）多次，C/C++ 中有两种宏实现方式：一种是 [\#ifndef][ifndef] 方式；另一种是 [\#pragma once][pragma once] 方式。**

在能够支持这两种方式的编译器上，二者并没有太大的区别。但两者仍然有一些细微的区别。

## **二.**\#pragmaonce\*\*\*\* 与 \#ifndef 使用 ##

### 1.\#ifndef ###

#ifndef  __SOMEFILE_H__
    #define   __SOMEFILE_H__
    
    ... ... // 声明、定义语句
    
    #endif

### 2.**\#pragmaonce** ###

#pragmaonce
    
    ... ... // 声明、定义语句

## \***\*三.\#pragmaonce** 与 \#ifndef\*\* 区别 ##

### 1.\#ifndef ###

\*\* [\#ifndef][ifndef] 的方式受 [C][] / [C++][C 1] 语言标准支持。它不仅可以保证同一个文件不会被包含多次，也能保证内容完全相同的两个文件（或者代码片段）不会被不小心同时包含。\*\*

当然，缺点就是如果不同头文件中的宏名不小心“撞车”，**注意宏的名字不要重复，可能就会导致你看到头文件明明存在，但编译器却硬说找不到声明的状况**——这种情况有时非常让人郁闷。

由于编译器每次都需要打开头文件才能判定是否有重复定义，因此在编译大型项目时，**ifndef 会使得编译时间相对较长**，因此一些编译器逐渐开始支持 \#pragma once 的方式。

### 2.\#pragma once ###

\#pragma once 一般由编译器提供保证：同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件，而不是指内容相同的两个文件。

**你无法对一个头文件中的一段代码作 pragma once 声明，而只能针对文件。**

其好处是，**使用 \#pragma once 不再担心宏名冲突了，当然也就不会出现宏名冲突引发的奇怪问题。大型项目的编译速度也因此提高了一些。**

对应的缺点就是如果某个头文件有多份拷贝，本方法不能保证他们不被重复包含。当然，相比宏名冲突引发的“找不到声明”的问题，这种重复包含很容易被发现并修正。

> **\#pragma once** 不支持跨平台！\*\*\#\*\*ifndef 支持跨平台！

## **四.**\#pragmaonce 与 \#ifndef\*\* 联系\*\* ##

[\#pragma once][pragma once] 方式产生于 \#ifndef 之后，因此很多人可能甚至没有听说过。目前看来 \#ifndef 更受到推崇。因为 \#ifndef 受 C / C++语言标准的支持，不受编译器的任何限制；

而 \#pragma once 方式却不受一些较老版本的编译器支持，一些支持了的编译器又打算去掉它，所以它的兼容性可能不够好。

一般而言，当程序员听到这样的话，都会选择 \#ifndef 方式，为了努力使得自己的代码“存活”时间更久，通常宁愿降低一些编译性能，这是程序员的个性，当然这是题外话啦。

还看到一种用法是把两者放在一起的：

#pragma once
    
    #ifndef __SOMEFILE_H__
    #define __SOMEFILE_H__
    
    .. ... // 声明、定义语句
    
    #endif

> 总结：
> 
> 看起来似乎是想兼有两者的优点。不过只要使用了\#ifndef 就会有宏名冲突的危险，也无法避免不支持 [\#pragma once][pragma once] 的编译器报错，所以混用两种方法似乎不能带来更多的好处，倒是会让一些不熟悉的人感到困惑。
> 
> 选择哪种方式，应该在了解两种方式的情况下，视具体情况而定。只要有一个合理的约定来避开缺点，我认为哪种方式都是可以接受的。而这个已经不是标准或者编译器的责任了，应当由程序员自己或者小范围内的开发规范来搞定。

## 五.猜你喜欢 ##

1.  [C 语言 数组下标越界和内存溢出区别][C _]
2.  [C 语言 指针声明和定义][C _ 1]
3.  [C 语言 指针 p++ / p–][C _ _ p_ _ p]
4.  [C 语言 *p++/*§++/\_(p++)/\_p++][C _ _p_p_p]
5.  [C 语言 使用指针遍历数组][C _ 2]
6.  [C 语言 指针和数组区别][C _ 3]
7.  [C 语言 指针数组和数组指针区别][C _ 4]
8.  [C 语言 空指针 NULL][C _ _ NULL]
9.  [C 语言 void 指针][C _ void]
10. [C 语言 野指针][C _ 5]
11. [C 语言 函数值传递和址传递][C _ 6]
12. [C 语言 函数缺省参数][C _ 7]
13. [C 语言 函数不定长参数][C _ 8]
14. [C 语言 函数指针][C _ 9]
15. [C 语言 指针函数][C _ 10]
16. [C 语言 回调函数 callback][C _ _ callback]
17. [C 语言 typedef][C _ typedef]
18. [C 语言 define 定义常量][C _ define]
19. [C 语言 define 防止头文件重复包含][ifndef]
20. [C 语言 \#pragma once][pragma once]

未经允许不得转载：[猿说编程][Link 1] » [C 语言 \#pragma once][pragma once]

[C_C_]: https://www.codersrc.com/c-c
[C]: https://www.codersrc.com/c%e8%af%ad%e8%a8%80%e5%9f%ba%e7%a1%80
[ifndef]: https://www.codersrc.com/archives/8912.html
[pragma once]: https://www.codersrc.com/archives/8931.html
[C 1]: https://www.codersrc.com/c%e9%9d%a2%e5%90%91%e5%af%b9%e8%b1%a1
[C _]: https://www.codersrc.com/archives/8331.html
[C _ 1]: https://www.codersrc.com/archives/8349.html
[C _ _ p_ _ p]: https://www.codersrc.com/archives/8456.html
[C _ _p_p_p]: https://www.codersrc.com/archives/8520.html
[C _ 2]: https://www.codersrc.com/archives/8540.html
[C _ 3]: https://www.codersrc.com/archives/8564.html
[C _ 4]: https://www.codersrc.com/archives/8613.html
[C _ _ NULL]: https://www.codersrc.com/archives/8674.html
[C _ void]: https://www.codersrc.com/archives/8690.html
[C _ 5]: https://www.codersrc.com/archives/8700.html
[C _ 6]: https://www.codersrc.com/archives/8738.html
[C _ 7]: https://www.codersrc.com/archives/8767.html
[C _ 8]: https://www.codersrc.com/archives/8780.html
[C _ 9]: https://www.codersrc.com/archives/8793.html
[C _ 10]: https://www.codersrc.com/archives/8809.html
[C _ _ callback]: https://www.codersrc.com/archives/8832.html
[C _ typedef]: https://www.codersrc.com/archives/8854.html
[C _ define]: https://www.codersrc.com/archives/8877.html
[Link 1]: https://www.codersrc.com