CheckLinkerFlag

於 3.18 版本新增。

檢查編譯器是否支援給定的連結旗標。

check_linker_flag

check_linker_flag(<lang> <flag> <var>)

檢查 <flag> 連結旗標是否被 <lang> 編譯器接受，且不會產生診斷訊息。結果會儲存在名為 <var> 的內部快取項目中。

此命令會暫時設定 CMAKE_REQUIRED_LINK_OPTIONS 變數，並從 check_source_compiles() 命令中呼叫 CheckSourceCompiles 模組。請參閱該模組的文件，以取得可能修改建置的其他變數列表。

底層實作依賴 LINK_OPTIONS 屬性來檢查指定的旗標。如 target_link_options() 命令中所述，可以使用 LINKER: 前綴。

此檢查的正面結果僅表示編譯器在給定連結旗標時沒有發出診斷訊息。該旗標是否具有任何效果，甚至特定的效果，都不在本模組的範圍內。

注意

由於 try_compile() 命令會轉發來自諸如 CMAKE_<LANG>_FLAGS 等變數的旗標，因此這些變數中未知的旗標可能會導致此檢查產生偽陰性結果。