怎么用Pragma來(lái)廢棄API

本篇內(nèi)容介紹了“怎么用Pragma來(lái)廢棄API”的有關(guān)知識(shí)，在實(shí)際案例的操作過(guò)程中，不少人都會(huì)遇到這樣的困境，接下來(lái)就讓小編帶領(lǐng)大家學(xué)習(xí)一下如何處理這些情況吧！希望大家仔細(xì)閱讀，能夠?qū)W有所成！

一、前言

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

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

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

這篇小短文就來(lái)聊一聊這個(gè)問(wèn)題。

二、操作過(guò)程

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

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

• api.h 和 api.c: 庫(kù)文件，編譯得到 libapi.so;

• 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)在，你覺(jué)得 init 這個(gè)函數(shù)是多余的，想把它去掉，可以這么來(lái)修改。

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)。

也就是說(shuō)：

在第一個(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ò)展開(kāi)來(lái)后就是讓編譯器在編譯可執(zhí)行程序時(shí)，打印出一段提示信息。

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

gcc main.c -o main -L./ -Wl,-rpath=./ -lapi

這樣就達(dá)到了最初的目的!也就是提示使用者：這個(gè)函數(shù)已經(jīng)被廢棄了，最好別用它!

三 _Prama 其他用法

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

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

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

(1) 第一種處理方式：

#ifdef   MY_API #define  MY_API  // 頭文件內(nèi)容  #endif

(2) 第二種處理方式

#pragma once  // 頭文件內(nèi)容

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

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

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

(3) 第三種處理方式

_Pragma("once")

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

• #pragma ：是一條預(yù)處理的指令，用來(lái)向編譯器傳達(dá)語(yǔ)言標(biāo)準(zhǔn)以外的一些信息，不能使用在宏中;

• _Pragma ：是一個(gè)操作符，屬于語(yǔ)言的標(biāo)準(zhǔn)，因此可以嵌套在宏中，就像上面示例中那樣;

#pragma 是編譯器的擴(kuò)展，也就是說(shuō)它是由編譯器來(lái)決定的，也許編譯器A支持，但是編譯器B就不一定支持了，雖然這種可能性比較小。

_Pragma 操作符是語(yǔ)言層面的標(biāo)準(zhǔn)，既然是標(biāo)準(zhǔn)，那么編譯器就必須要遵循標(biāo)準(zhǔn)，所以也推薦使用這種方式。

記得侯杰老師在 C++ 的視頻課程中說(shuō)到：我們寫代碼，不僅僅要保證功能上的正確，而且要把代碼寫的很大氣!我感覺(jué)用 _Pragma 可能比 #ifndef  更大氣一些。

2. 輸出編譯信息

#pragma message("the #pragma way") _Pragma ("message( \"the _Pragma way\")")

上面兩行的內(nèi)容輸出信息是一樣的，需要注意的是嵌套的雙引號(hào)需要用反斜線去轉(zhuǎn)義。

“怎么用Pragma來(lái)廢棄API”的內(nèi)容就介紹到這里了，感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識(shí)可以關(guān)注億速云網(wǎng)站，小編將為大家輸出更多高質(zhì)量的實(shí)用文章！