# FindIntl

Added in version 3.2.

Finds internationalization support that includes message translation functions such as `gettext()`. These functions originate from the GNU `libintl` library, which is part of the GNU gettext utilities, but may also be provided by the standard C library.

## Imported Targets

This module provides the following Imported Targets:

`Intl::Intl`

  Added in version 3.20.

  Target encapsulating the Intl usage requirements, available if Intl is found.

## Result Variables

This module defines the following variables:

`Intl_FOUND`

  Boolean indicating whether the Intl is found.

`Intl_INCLUDE_DIRS`

  Include directories containing headers needed to use Intl.

`Intl_LIBRARIES`

  The libraries needed to link against to use Intl.

`Intl_VERSION`

  Added in version 3.21.

  The version of the found Intl implementation or library, in the format `x.y.z`.

  Note

  Some Intl implementations don't embed the version in their header files. In this case the variables `Intl_VERSION*` will be empty.

`Intl_VERSION_MAJOR`

  Added in version 3.21.

  The major version of Intl found.

`Intl_VERSION_MINOR`

  Added in version 3.21.

  The minor version of Intl found.

`Intl_VERSION_PATCH`

  Added in version 3.21.

  The patch version of Intl found.

## Cache Variables

The following cache variables may also be set:

`Intl_INCLUDE_DIR`

  The directory containing the `libintl.h` header file.

`Intl_LIBRARY`

  The path to the Intl library (if any).

`Intl_IS_BUILT_IN`

  Added in version 3.20.

  Boolean indicating whether the found Intl functionality is provided by the standard C library rather than a separate `libintl` library.

Note

On some platforms, such as Linux with GNU libc, the gettext functions are present in the C standard library and libintl is not required. The `Intl_LIBRARY` and `Intl_INCLUDE_DIR` will be empty in this case.

## Examples

Finding the Intl support and linking the imported target for use in a project:

    find_package(Intl)
    target_link_libraries(app PRIVATE Intl::Intl)

## See Also

- The `FindGettext` module to find and use the GNU gettext tools (`msgmerge`, `msgfmt`, etc.).