CMake編譯命令target_compile_options簡(jiǎn)介

本文使用的相關(guān)軟件環(huán)境信息如下:

軟件名稱 軟件版本
Linux操作系統(tǒng) Ubuntu 22.04 LTS(X64)
cmake 3.22.1
g++ 11.4.0
  • target_compile_options

    命令格式:

    target_compile_options(<target> [BEFORE]
      <INTERFACE|PUBLIC|PRIVATE> [items1...]
      [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
    

    該命令添加編譯選項(xiàng)到編譯目標(biāo)中太惠,與add_compile_options不同的是吗购,target_compile_options針對(duì)構(gòu)建的目標(biāo)添加編譯選項(xiàng)旷坦,而add_compile_options是針對(duì)源文件添加預(yù)編譯選項(xiàng)(實(shí)際上也隱含對(duì)當(dāng)前構(gòu)建目標(biāo)添加編譯選項(xiàng))庸诱。

    因此,target_compile_options要求構(gòu)建目標(biāo)已經(jīng)存在粗卜,也就是被add_executable()或add_library()等函數(shù)創(chuàng)建出來(lái)屋确。此外,target_compile_options還要求對(duì)每一個(gè)編譯選項(xiàng)指定范圍休建,范圍有三個(gè)選項(xiàng):PUBLIC、PRIVATE和INTERFACE评疗。通過PUBLIC和PRIVATE范圍限定的預(yù)編譯選項(xiàng)會(huì)被添加到構(gòu)建目標(biāo)的COMPILE_OPTIONS屬性中测砂,通過PUBLIC和INTERFACE范圍限定的預(yù)編譯選項(xiàng)會(huì)被添加到構(gòu)建目標(biāo)的INTERFACE_COMPILE_OPTIONS屬性中“俅遥總結(jié)起來(lái)就是PUBLIC既給自己用砌些,也給別人用;PRIVATE只給自己用加匈;INTERFACE只給別人用存璃。

    當(dāng)多個(gè)構(gòu)建目標(biāo)在一起鏈接的時(shí),最終的可執(zhí)行文件會(huì)將各個(gè)構(gòu)建目標(biāo)的INTERFACE_COMPILE_OPTIONS屬性繼承過來(lái)雕拼。

    總體來(lái)說(shuō)纵东,target_compile_options與add_compile_options的關(guān)系,和add_compile_definitions與target_compile_definitions的關(guān)系類似啥寇。下面通過一個(gè)例子來(lái)演示一下:

    1偎球、構(gòu)建一個(gè)test庫(kù),對(duì)test使用PUBLIC辑甜、PRIVATE和INTERFACE三個(gè)編譯選項(xiàng)衰絮,分別對(duì)應(yīng)編譯選項(xiàng)-Wunused-variable(未使用的變量)、-Wreturn-type(函數(shù)缺少返回值)磷醋、-Wuninitialized(變量使用前未初始化)猫牡;

    2、構(gòu)建一個(gè)main可執(zhí)行文件邓线,對(duì)main使用PRIVATE的編譯選項(xiàng)-Wunused-parameter(從未使用過的函數(shù)參數(shù))淌友;

    3、對(duì)test.cpp和main.cpp都模擬未使用的變量骇陈、函數(shù)缺少返回值亩进、變量使用前未初始化、從未使用過的函數(shù)參數(shù)這4種情況缩歪。

    CMakeLists.txt文件內(nèi)容:

    CMAKE_MINIMUM_REQUIRED(VERSION 3.22)
    PROJECT(compile_options_test)
    
    ADD_LIBRARY(test test.cpp)
    TARGET_COMPILE_OPTIONS(test
                            PUBLIC -Wunused-variable
                            PRIVATE -Wreturn-type
                            INTERFACE -Wuninitialized)
    
    ADD_EXECUTABLE(main main.cpp)
    TARGET_COMPILE_OPTIONS(main
                            PRIVATE -Wunused-parameter)
    
    TARGET_LINK_LIBRARIES(main test)
    

    test.h文件內(nèi)容

    #ifndef __TEST_TT__
    #define __TEST_TT__
    
    int test(int para);
    
    #endif
    

    test.cpp文件內(nèi)容:

    #include "test.h"
    
    int test(int para/* 未使用的函數(shù)參數(shù) */)
    {
        int a = 5; // 未使用的變量
        int i; // 未初始化的變量
        if (i == 0) {
            
        }
        // 函數(shù)缺少返回值
    }
    

    main.cpp文件內(nèi)容:

    #include "test.h"
    
    int main(int argc, char** argv /* 未使用的函數(shù)參數(shù) */)
    {
        const char* not_use_var = "Hello world!"; // 未使用的變量
        int i; // 未初始化的變量
        test(i);
        //return 0; // 函數(shù)缺少返回值
    }
    

    運(yùn)行cmake .make VERBOSE=1归薛,關(guān)鍵信息輸出如下:

    ……
    [ 25%] Building CXX object CMakeFiles/test.dir/test.cpp.o
    /usr/bin/c++   -Wunused-variable -Wreturn-type -MD -MT CMakeFiles/test.dir/test.cpp.o -MF CMakeFiles/test.dir/test.cpp.o.d -o CMakeFiles/test.dir/test.cpp.o -c /XXX/test.cpp
    /XXX/test.cpp: In function ‘int test(int)’:
    /XXX/test.cpp:5:9: warning: unused variable ‘a(chǎn)’ [-Wunused-variable]
        5 |     int a = 5; // 未使用的變量
          |         ^
    /XXX/test.cpp:11:1: warning: no return statement in function returning non-void [-Wreturn-type]
       11 | }
          | ^
    [ 50%] Linking CXX static library libtest.a
    ……
    [ 75%] Building CXX object CMakeFiles/main.dir/main.cpp.o
    /usr/bin/c++   -Wunused-parameter -Wunused-variable -Wuninitialized -MD -MT CMakeFiles/main.dir/main.cpp.o -MF CMakeFiles/main.dir/main.cpp.o.d -o CMakeFiles/main.dir/main.cpp.o -c /XXX/main.cpp
    /XXX/main.cpp: In function ‘int main(int, char**)’:
    /XXX/main.cpp:5:17: warning: unused variable ‘not_use_var’ [-Wunused-variable]
        5 |     const char* not_use_var = "Hello world!"; // 未使用的變量
          |                 ^~~~~~~~~~~
    /XXX/main.cpp:3:14: warning: unused parameter ‘a(chǎn)rgc’ [-Wunused-parameter]
        3 | int main(int argc, char** argv /* 未使用的函數(shù)參數(shù) */)
          |          ~~~~^~~~
    /XXX/main.cpp:3:27: warning: unused parameter ‘a(chǎn)rgv’ [-Wunused-parameter]
        3 | int main(int argc, char** argv /* 未使用的函數(shù)參數(shù) */)
          |                    ~~~~~~~^~~~
    /XXX/main.cpp:7:9: warning: ‘i’ is used uninitialized [-Wuninitialized]
        7 |     test(i);
          |     ~~~~^~~
    [100%] Linking CXX executable main
    

    可以看到,對(duì)于test庫(kù),其PUBLIC和PRIVATE編譯選項(xiàng)生效主籍,2種告警提示习贫;對(duì)于main可執(zhí)行文件,繼承了test庫(kù)的PUBLIC和INTERFACE編譯選項(xiàng)千元,加上自身的PRIVATE編譯選項(xiàng)苫昌,3種告警提示。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末幸海,一起剝皮案震驚了整個(gè)濱河市祟身,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌物独,老刑警劉巖袜硫,帶你破解...
    沈念sama閱讀 211,348評(píng)論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異挡篓,居然都是意外死亡婉陷,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,122評(píng)論 2 385
  • 文/潘曉璐 我一進(jìn)店門官研,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)秽澳,“玉大人,你說(shuō)我怎么就攤上這事戏羽〉I瘢” “怎么了?”我有些...
    開封第一講書人閱讀 156,936評(píng)論 0 347
  • 文/不壞的土叔 我叫張陵始花,是天一觀的道長(zhǎng)杏瞻。 經(jīng)常有香客問我,道長(zhǎng)衙荐,這世上最難降的妖魔是什么捞挥? 我笑而不...
    開封第一講書人閱讀 56,427評(píng)論 1 283
  • 正文 為了忘掉前任野舶,我火速辦了婚禮烹植,結(jié)果婚禮上苗膝,老公的妹妹穿的比我還像新娘政己。我一直安慰自己而芥,他們只是感情好排作,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,467評(píng)論 6 385
  • 文/花漫 我一把揭開白布泡挺。 她就那樣靜靜地躺著渐裸,像睡著了一般煌抒。 火紅的嫁衣襯著肌膚如雪仍劈。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,785評(píng)論 1 290
  • 那天寡壮,我揣著相機(jī)與錄音贩疙,去河邊找鬼讹弯。 笑死,一個(gè)胖子當(dāng)著我的面吹牛这溅,可吹牛的內(nèi)容都是我干的组民。 我是一名探鬼主播,決...
    沈念sama閱讀 38,931評(píng)論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼悲靴,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼臭胜!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起癞尚,我...
    開封第一講書人閱讀 37,696評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤耸三,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后浇揩,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體仪壮,經(jīng)...
    沈念sama閱讀 44,141評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡临燃,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,483評(píng)論 2 327
  • 正文 我和宋清朗相戀三年睛驳,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了烙心。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片膜廊。...
    茶點(diǎn)故事閱讀 38,625評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖淫茵,靈堂內(nèi)的尸體忽然破棺而出爪瓜,到底是詐尸還是另有隱情,我是刑警寧澤匙瘪,帶...
    沈念sama閱讀 34,291評(píng)論 4 329
  • 正文 年R本政府宣布铆铆,位于F島的核電站,受9級(jí)特大地震影響丹喻,放射性物質(zhì)發(fā)生泄漏薄货。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,892評(píng)論 3 312
  • 文/蒙蒙 一碍论、第九天 我趴在偏房一處隱蔽的房頂上張望谅猾。 院中可真熱鬧,春花似錦鳍悠、人聲如沸税娜。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,741評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)敬矩。三九已至,卻和暖如春蠢挡,著一層夾襖步出監(jiān)牢的瞬間弧岳,已是汗流浹背凳忙。 一陣腳步聲響...
    開封第一講書人閱讀 31,977評(píng)論 1 265
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留缩筛,地道東北人消略。 一個(gè)月前我還...
    沈念sama閱讀 46,324評(píng)論 2 360
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像瞎抛,于是被迫代替她去往敵國(guó)和親艺演。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,492評(píng)論 2 348

推薦閱讀更多精彩內(nèi)容