小知識 | 嵌入式C中#pragma once的作用是什么？

關(guān)注「嵌入式大雜燴」，選擇「星標(biāo)公眾號」一起進(jìn)步！

大家好，我是ZhengN。本次給大家分享一個(gè)C/C 的小知識——#pragma once。

我之前也沒用過#pragma once，直到看到同事的代碼有用到，所以去了解了一下。分享一篇博文：

?https://blog.csdn.net/fanyun_01/article/details/77413992

?

1、#pragma once有什么作用？

為了避免同一個(gè)頭文件被包含（include）多次，C/C 中有兩種宏實(shí)現(xiàn)方式：一種是#ifndef方式；另一種是#pragma once方式。

在能夠支持這兩種方式的編譯器上，二者并沒有太大的區(qū)別。但兩者仍然有一些細(xì)微的區(qū)別。

2、兩者的使用方式有何區(qū)別？

示例代碼如下：

//方式一：
#ifndef??__SOMEFILE_H__
#define???__SOMEFILE_H__
?...?...?//?聲明、定義語句
#endif

//方式二：
#pragmaonce
?...?...?//?聲明、定義語句


3、兩者各有何特點(diǎn)？

（1）#ifndef

#ifndef的方式受C/C 語言標(biāo)準(zhǔn)支持。它不僅可以保證同一個(gè)文件不會(huì)被包含多次，也能保證內(nèi)容完全相同的兩個(gè)文件（或者代碼片段）不會(huì)被不小心同時(shí)包含。

當(dāng)然，缺點(diǎn)就是如果不同頭文件中的宏名不小心“撞車”，可能就會(huì)導(dǎo)致你看到頭文件明明存在，但編譯器卻硬說找不到聲明的狀況——這種情況有時(shí)非常讓人郁悶。

由于編譯器每次都需要打開頭文件才能判定是否有重復(fù)定義，因此在編譯大型項(xiàng)目時(shí)，ifndef會(huì)使得編譯時(shí)間相對較長，因此一些編譯器逐漸開始支持#pragma once的方式。

（2）#pragma once

#pragma once 一般由編譯器提供保證：同一個(gè)文件不會(huì)被包含多次。注意這里所說的“同一個(gè)文件”是指物理上的一個(gè)文件，而不是指內(nèi)容相同的兩個(gè)文件。

你無法對一個(gè)頭文件中的一段代碼作pragma once聲明，而只能針對文件。

其好處是，你不必再擔(dān)心宏名沖突了，當(dāng)然也就不會(huì)出現(xiàn)宏名沖突引發(fā)的奇怪問題。大型項(xiàng)目的編譯速度也因此提高了一些。

對應(yīng)的缺點(diǎn)就是如果某個(gè)頭文件有多份拷貝，本方法不能保證他們不被重復(fù)包含。當(dāng)然，相比宏名沖突引發(fā)的“找不到聲明”的問題，這種重復(fù)包含很容易被發(fā)現(xiàn)并修正。

另外，這種方式不支持跨平臺(tái)！

4、兩者之間有什么聯(lián)系？

#pragma once 方式產(chǎn)生于#ifndef之后，因此很多人可能甚至沒有聽說過。目前看來#ifndef更受到推崇。因?yàn)?ifndef受C/C 語言標(biāo)準(zhǔn)的支持，不受編譯器的任何限制；

而#pragma once方式卻不受一些較老版本的編譯器支持，一些支持了的編譯器又打算去掉它，所以它的兼容性可能不夠好。

一般而言，當(dāng)程序員聽到這樣的話，都會(huì)選擇#ifndef方式，為了努力使得自己的代碼“存活”時(shí)間更久，通常寧愿降低一些編譯性能，這是程序員的個(gè)性，當(dāng)然這是題外話啦。

還看到一種用法是把兩者放在一起的：

#pragma?once
#ifndef?__SOMEFILE_H__
#define?__SOMEFILE_H__

...?...?//?聲明、定義語句

#endif
總結(jié)：

看起來似乎是想兼有兩者的優(yōu)點(diǎn)。不過只要使用了#ifndef就會(huì)有宏名沖突的危險(xiǎn)，也無法避免不支持#pragma once的編譯器報(bào)錯(cuò)，所以混用兩種方法似乎不能帶來更多的好處，倒是會(huì)讓一些不熟悉的人感到困惑。

選擇哪種方式，應(yīng)該在了解兩種方式的情況下，視具體情況而定。只要有一個(gè)合理的約定來避開缺點(diǎn)，我認(rèn)為哪種方式都是可以接受的。而這個(gè)已經(jīng)不是標(biāo)準(zhǔn)或者編譯器的責(zé)任了，應(yīng)當(dāng)由程序員自己或者小范圍內(nèi)的開發(fā)規(guī)范來搞定。

為了避免同一個(gè)文件被include多次：

1、#ifndef方式?

2、#pragma once方式

在能夠支持這兩種方式的編譯器上，二者并沒有太大的區(qū)別，但是兩者仍然還是有一些細(xì)微的區(qū)別。

方式一：

#ifndef?__SOMEFILE_H__
#define?__SOMEFILE_H__
...?...?//?一些聲明語句
#endif

方式二：

#pragma?once
...?...?//?一些聲明語句
#ifndef的方式依賴于宏名字不能沖突，這不光可以保證同一個(gè)文件不會(huì)被包含多次，也能保證內(nèi)容完全相同的兩個(gè)文件不會(huì)被不小心同時(shí)包含。當(dāng)然，缺點(diǎn)就是如果不同頭文件的宏名不小心“撞車”，可能就會(huì)導(dǎo)致頭文件明明存在，編譯器卻硬說找不到聲明的狀況。

#pragma once則由編譯器提供保證：同一個(gè)文件不會(huì)被包含多次。注意這里所說的“同一個(gè)文件”是指物理上的一個(gè)文件，而不是指內(nèi)容相同的兩個(gè)文件。帶來的好處是，你不必再費(fèi)勁想個(gè)宏名了，當(dāng)然也就不會(huì)出現(xiàn)宏名碰撞引發(fā)的奇怪問題。

對應(yīng)的缺點(diǎn)就是如果某個(gè)頭文件有多份拷貝，本方法不能保證他們不被重復(fù)包含。當(dāng)然，相比宏名碰撞引發(fā)的“找不到聲明”的問題，重復(fù)包含更容易被發(fā)現(xiàn)并修正。

方式一由語言支持所以移植性好，方式二 可以避免名字沖突。

本文來源網(wǎng)絡(luò)，版權(quán)歸原作者所有。如涉及作品版權(quán)問題，請聯(lián)系我進(jìn)行刪除。

往期干貨：

往期推薦

嵌入式項(xiàng)目生成器，了解一下！

一個(gè)清晰的LCD驅(qū)動(dòng)編寫思路（附代碼分析）

RT-Thread和Freertos的區(qū)別？

程序如何運(yùn)行？編譯、鏈接、裝入？