• 一、前言

  
  

• 二、操作過程

  
  

• 三、 _Prama 其他用法

  
  

一、前言

想象一下這個(gè)工作場(chǎng)景：你在為一個(gè)項(xiàng)目寫一個(gè)功能庫(kù)，別人調(diào)用庫(kù)中提供的函數(shù)，后來你發(fā)現(xiàn)庫(kù)里的函數(shù)A是多余的。

具有完美情節(jié)的你，就是想把這個(gè)函數(shù)A廢棄掉，此時(shí)肯定是不能直接刪掉，因?yàn)槟悴恢绖e人在多少個(gè)地方調(diào)用了這個(gè)函數(shù)。

這種情況如何處理比較好呢？

這篇小短文就來聊一聊這個(gè)問題。

二、操作過程

1. 第一個(gè)版本的庫(kù)

測(cè)試文件只有 3 個(gè)：api.h, api.c 和 main.c

1. api.h 和 api.c: 庫(kù)文件，編譯得到 libapi.so；
2. main.c：生成可執(zhí)行程序，利用了上面生成的庫(kù) libapi.so;

api.h 文件內(nèi)容：聲明了 2 個(gè)函數(shù)。

api.c 文件內(nèi)容：定義了 2 個(gè)函數(shù)。

編譯得到庫(kù)文件 libapi.so。編譯指令：

gcc -fPIC -shared api.c -o libapi.so
main.c 文件內(nèi)容：

編譯得到可執(zhí)行文件：

gcc main.c -o main -L./ -Wl,-rpath=./ -lapi
以上代碼的簡(jiǎn)單程度，等價(jià)于 helloworld 了。

2. 第二個(gè)版本的庫(kù)

現(xiàn)在，你覺得 init 這個(gè)函數(shù)是多余的，想把它去掉，可以這么來修改。

api.c 文件中，把 init() 函數(shù)刪除掉。

api.h 文件內(nèi)容改為如下：

關(guān)鍵代碼是這一行：

#define init() (1) API_DEPRECATED
既然 api.c 文件已經(jīng)把這個(gè)函數(shù)刪除了，但是 main.c 文件中又調(diào)用了這個(gè)函數(shù)，因此以宏定義的形式提供 init 這個(gè)符號(hào)。

也就是說：

在第一個(gè)版本中，main.c 文件中的 init 是一個(gè)函數(shù)，被編譯器處理，在鏈接階段從 libapi.so 庫(kù)中找到這個(gè)函數(shù)的地址；

在第二個(gè)版本中，init 被定義成宏，在預(yù)處理階段被替換成后面的(1) API_DEPRECATED。

(1) 是在宏替換時(shí)的表達(dá)式。因?yàn)檫@個(gè)函數(shù)可能被用在 if 條件判斷中，因此需要返回一個(gè)值。
API_DEPRECATED 是另一個(gè)宏定義，擴(kuò)展開來后就是讓編譯器在編譯可執(zhí)行程序時(shí)，打印出一段提示信息。

在編譯可執(zhí)行文件時(shí)，編譯器輸出下面的這段話：

gcc main.c -o main -L./ -Wl,-rpath=./ -lapi
這樣就達(dá)到了最初的目的！也就是提示使用者：這個(gè)函數(shù)已經(jīng)被廢棄了，最好別用它！

三 _Prama 其他用法

_Pragma 類似于 Microsoft 特定的 __pragma 關(guān)鍵字，只不過它是標(biāo)準(zhǔn)的一部分。它是在 C99 中為 C 引入的。對(duì)于 c ，它是在 c 11 中引入的。它允許將指令放入宏定義中。

1. 處理頭文件重復(fù)包含

在頭文件中，為了防止被重復(fù)包含，一般有 3 種處理方式：

(1) 第一種處理方式：

#ifndef MY_API#define MY_API
// 頭文件內(nèi)容
#endif
(2) 第二種處理方式

#pragma once
// 頭文件內(nèi)容
以上這 2 種方式都可以防止同一個(gè)頭文件被重復(fù)包含，但是還是有一些區(qū)別的。

第一種方式：預(yù)處理器還是需要去搜尋文件，然后打開文件，讀取文件的內(nèi)容之后，檢查 MY_API 是否已經(jīng)被定義過。

第二種方式：能加快編譯速度，因?yàn)檫@是一種高端的機(jī)制；編譯器會(huì)自動(dòng)比對(duì)文件名，而不需要在頭文件去判斷 #ifndef 和 #endif，這樣就省去了中間的搜尋、打開和讀取操作。

(3) 第三種處理方式

_Pragma("once")
這種方式與第二種方式的區(qū)別是：

#pragma ：是一條預(yù)處理的指令，用來向編譯器傳達(dá)語言標(biāo)準(zhǔn)以外的一些信息，不能使用在宏中；
_Pragma ：是一個(gè)操作符，屬于語言的標(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)容輸出信息是一樣的，需要注意的是嵌套的雙引號(hào)需要用反斜線去轉(zhuǎn)義。

That's All! 周末愉快！