C語言:如何利用_Pragma溫柔的廢棄API?
一、前言
想象一下這個工作場景:你在為一個項(xiàng)目寫一個功能庫,別人調(diào)用庫中提供的函數(shù),后來你發(fā)現(xiàn)庫里的函數(shù)A是多余的。
具有完美情節(jié)的你,就是想把這個函數(shù)A廢棄掉,此時肯定是不能直接刪掉,因?yàn)槟悴恢绖e人在多少個地方調(diào)用了這個函數(shù)。
這種情況如何處理比較好呢?
這篇小短文就來聊一聊這個問題。
二、操作過程
1. 第一個版本的庫
測試文件只有 3 個:api.h, api.c 和 main.c
api.h 和 api.c: 庫文件,編譯得到 libapi.so;main.c:生成可執(zhí)行程序,利用了上面生成的庫 libapi.so;
api.h 文件內(nèi)容:聲明了 2 個函數(shù)。
api.c 文件內(nèi)容:定義了 2 個函數(shù)。
編譯得到庫文件 libapi.so。編譯指令:
gcc -fPIC -shared api.c -o libapi.so
main.c 文件內(nèi)容:
編譯得到可執(zhí)行文件:
gcc main.c -o main -L./ -Wl,-rpath=./ -lapi
以上代碼的簡單程度,等價于 helloworld 了。
2. 第二個版本的庫
現(xiàn)在,你覺得 init 這個函數(shù)是多余的,想把它去掉,可以這么來修改。
api.c 文件中,把 init() 函數(shù)刪除掉。
api.h 文件內(nèi)容改為如下:
關(guān)鍵代碼是這一行:
#define init() (1) API_DEPRECATED
既然 api.c 文件已經(jīng)把這個函數(shù)刪除了,但是 main.c 文件中又調(diào)用了這個函數(shù),因此以宏定義的形式提供 init 這個符號。
也就是說:
在第一個版本中,main.c 文件中的 init 是一個函數(shù),被編譯器處理,在鏈接階段從 libapi.so 庫中找到這個函數(shù)的地址;
在第二個版本中,init 被定義成宏,在預(yù)處理階段被替換成后面的 (1) API_DEPRECATED。
(1) 是在宏替換時的表達(dá)式。因?yàn)檫@個函數(shù)可能被用在 if 條件判斷中,因此需要返回一個值。
API_DEPRECATED 是另一個宏定義,擴(kuò)展開來后就是讓編譯器在編譯可執(zhí)行程序時,打印出一段提示信息。
在編譯可執(zhí)行文件時,編譯器輸出下面的這段話:
gcc main.c -o main -L./ -Wl,-rpath=./ -lapi
這樣就達(dá)到了最初的目的!也就是提示使用者:這個函數(shù)已經(jīng)被廢棄了,最好別用它!
三 _Prama 其他用法
_Pragma 類似于 Microsoft 特定的 __pragma 關(guān)鍵字,只不過它是標(biāo)準(zhǔn)的一部分。它是在 C99 中為 C 引入的。對于 c + +,它是在 c + + 11 中引入的。它允許將指令放入宏定義中。
1. 處理頭文件重復(fù)包含
在頭文件中,為了防止被重復(fù)包含,一般有 3 種處理方式:
(1) 第一種處理方式:
#ifdef MY_API#define MY_API
// 頭文件內(nèi)容
#endif
(2) 第二種處理方式
#pragma once
// 頭文件內(nèi)容
以上這 2 種方式都可以防止同一個頭文件被重復(fù)包含,但是還是有一些區(qū)別的。
第一種方式:預(yù)處理器還是需要去搜尋文件,然后打開文件,讀取文件的內(nèi)容之后,檢查 MY_API 是否已經(jīng)被定義過。
第二種方式:能加快編譯速度,因?yàn)檫@是一種高端的機(jī)制;編譯器會自動比對文件名,而不需要在頭文件去判斷 #ifndef 和 #endif,這樣就省去了中間的搜尋、打開和讀取操作。
(3) 第三種處理方式
_Pragma("once")
這種方式與第二種方式的區(qū)別是:
#pragma :是一條預(yù)處理的指令,用來向編譯器傳達(dá)語言標(biāo)準(zhǔn)以外的一些信息,不能使用在宏中;
_Pragma :是一個操作符,屬于語言的標(biāo)準(zhǔn),因此可以嵌套在宏中,就像上面示例中那樣;
#pragma 是編譯器的擴(kuò)展,也就是說它是由編譯器來決定的,也許編譯器A支持,但是編譯器B就不一定支持了,雖然這種可能性比較小。
_Pragma 操作符是語言層面的標(biāo)準(zhǔn),既然是標(biāo)準(zhǔn),那么編譯器就必須要遵循標(biāo)準(zhǔn),所以也推薦使用這種方式。
記得侯杰老師在 C++ 的視頻課程中說到:我們寫代碼,不僅僅要保證功能上的正確,而且要把代碼寫的很大氣!我感覺用 _Pragma 可能比 #ifndef 更大氣一些。
2. 輸出編譯信息#pragma message("the #pragma way")_Pragma ("message( "the _Pragma way")")
上面兩行的內(nèi)容輸出信息是一樣的,需要注意的是嵌套的雙引號需要用反斜線去轉(zhuǎn)義。
That's All! 周末愉快!
請輸入評論內(nèi)容...
請輸入評論/評論長度6~500個字
最新活動更多
-
10月31日立即下載>> 【限時免費(fèi)下載】TE暖通空調(diào)系統(tǒng)高效可靠的組件解決方案
-
即日-11.13立即報名>>> 【在線會議】多物理場仿真助跑新能源汽車
-
11月28日立即報名>>> 2024工程師系列—工業(yè)電子技術(shù)在線會議
-
12月19日立即報名>> 【線下會議】OFweek 2024(第九屆)物聯(lián)網(wǎng)產(chǎn)業(yè)大會
-
即日-12.26火熱報名中>> OFweek2024中國智造CIO在線峰會
-
即日-2025.8.1立即下載>> 《2024智能制造產(chǎn)業(yè)高端化、智能化、綠色化發(fā)展藍(lán)皮書》
推薦專題
- 高級軟件工程師 廣東省/深圳市
- 自動化高級工程師 廣東省/深圳市
- 光器件研發(fā)工程師 福建省/福州市
- 銷售總監(jiān)(光器件) 北京市/海淀區(qū)
- 激光器高級銷售經(jīng)理 上海市/虹口區(qū)
- 光器件物理工程師 北京市/海淀區(qū)
- 激光研發(fā)工程師 北京市/昌平區(qū)
- 技術(shù)專家 廣東省/江門市
- 封裝工程師 北京市/海淀區(qū)
- 結(jié)構(gòu)工程師 廣東省/深圳市