FindIconv

版本 3.11 新增。

此模組在系統上尋找 iconv() POSIX.1 函數。這些函數可能在常規 C 函式庫中提供，或以額外函式庫的形式在外部提供。

以下變數用於指示 iconv 支援

Iconv_FOUND

變數指示是否找到 iconv 支援。

Iconv_INCLUDE_DIRS

包含 iconv 標頭的目錄。

Iconv_LIBRARIES

要連結的 iconv 函式庫。

Iconv_VERSION

版本 3.21 新增。

找到的 iconv 版本 (x.y)

Iconv_VERSION_MAJOR

版本 3.21 新增。

iconv 的主要版本

Iconv_VERSION_MINOR

版本 3.21 新增。

iconv 的次要版本

Iconv_IS_BUILT_IN

一個變數，指示 iconv 支援是否源自 C 函式庫。即使 C 函式庫提供了 iconv()，外部 libiconv 實作的存在也可能導致此變數為 false。

此外，還提供了以下 IMPORTED 目標

Iconv::Iconv

用於使用 iconv 的匯入目標。

以下快取變數也可能被設定

Iconv_INCLUDE_DIR

包含 iconv 標頭的目錄。

Iconv_LIBRARY

iconv 函式庫（如果未在 C 函式庫中隱式給出）。

注意

在 POSIX 平台上，iconv 可能是 C 函式庫的一部分，且快取變數 Iconv_INCLUDE_DIR 和 Iconv_LIBRARY 可能為空。

注意

某些 libiconv 實作未在其標頭檔中嵌入版本號。在這種情況下，變數 Iconv_VERSION* 將為空。