CheckLinkerFlag

加入於版本 3.18。

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

check_linker_flag

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

檢查連結 <flag> 是否被 <lang> 編譯器接受，且沒有診斷訊息。 結果儲存在名為 <var> 的內部快取條目中。

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

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

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

注意

由於 try_compile() 命令從諸如 CMAKE_<LANG>_FLAGS 之類的變數轉發旗標，因此這些變數中未知的旗標可能會導致此檢查出現誤判的結果。