FindIconv

From Get docs
Cmake/docs/3.21/module/findiconv


FindIconv

New in version 3.11.


This module finds the iconv() POSIX.1 functions on the system. These functions might be provided in the regular C library or externally in the form of an additional library.

The following variables are provided to indicate iconv support:

Iconv_FOUND
Variable indicating if the iconv support was found.
Iconv_INCLUDE_DIRS
The directories containing the iconv headers.
Iconv_LIBRARIES
The iconv libraries to be linked.
Iconv_VERSION

New in version 3.21.

The version of iconv found (x.y)

Iconv_VERSION_MAJOR

New in version 3.21.

The major version of iconv

Iconv_VERSION_MINOR

New in version 3.21.

The minor version of iconv

Iconv_IS_BUILT_IN
A variable indicating whether iconv support is stemming from the C library or not. Even if the C library provides iconv(), the presence of an external libiconv implementation might lead to this being false.

Additionally, the following IMPORTED target is being provided:

Iconv::Iconv
Imported target for using iconv.

The following cache variables may also be set:

Iconv_INCLUDE_DIR
The directory containing the iconv headers.
Iconv_LIBRARY
The iconv library (if not implicitly given in the C library).

Note

On POSIX platforms, iconv might be part of the C library and the cache variables Iconv_INCLUDE_DIR and Iconv_LIBRARY might be empty.


Note

Some libiconv implementations don't embed the version number in their header files. In this case the variables Iconv_VERSION* will be empty.


© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.21/module/FindIconv.html