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* 將為空。