# CheckFunctionExists

Check if a C function can be linked

`check_function_exists`

      check_function_exists(<function> <variable>)

  Checks that the `<function>` is provided by libraries on the system and store the result in a `<variable>`, which will be created as an internal cache variable.

The following variables may be set before calling this macro to modify the way the check is run:

`CMAKE_REQUIRED_FLAGS`

  string of compile command line flags.

`CMAKE_REQUIRED_DEFINITIONS`

  a ;-list of macros to define (-DFOO=bar).

`CMAKE_REQUIRED_INCLUDES`

  a ;-list of header search paths to pass to the compiler.

`CMAKE_REQUIRED_LINK_OPTIONS`

  a ;-list of options to add to the link command.

`CMAKE_REQUIRED_LIBRARIES`

  a ;-list of libraries to add to the link command. See policy `CMP0075`.

`CMAKE_REQUIRED_QUIET`

  execute quietly without messages.

Note

Prefer using `CheckSymbolExists` instead of this module, for the following reasons:

- `check_function_exists()` can’t detect functions that are inlined in headers or specified as a macro.

- `check_function_exists()` can’t detect anything in the 32-bit versions of the Win32 API, because of a mismatch in calling conventions.

- `check_function_exists()` only verifies linking, it does not verify that the function is declared in system headers.