# FindCurses

Finds the curses or ncurses library.

Curses is a terminal control library for Unix-like systems, used to build text user interface (TUI) applications. Originally developed in 1978, it has since evolved into multiple implementations, most notably ncurses (new curses), BSD curses, and PDCurses (a public domain curses library for non-Unix platforms).

## Result Variables

This module defines the following variables:

`Curses_FOUND`

  Boolean indicating whether the Curses is found. For backward compatibility, the `CURSES_FOUND` variable is also set to the same value.

`CURSES_INCLUDE_DIRS`

  Added in version 3.1.

  The include directories needed to use Curses.

`CURSES_LIBRARIES`

  The libraries needed to use Curses.

`CURSES_CFLAGS`

  Added in version 3.16.

  Compiler flags which ought be given to C/C++ compilers when using Curses.

`CURSES_HAVE_CURSES_H`

  Boolean indicating whether `curses.h` is available.

`CURSES_HAVE_NCURSES_H`

  Boolean indicating whether `ncurses.h` is available.

`CURSES_HAVE_NCURSES_NCURSES_H`

  Boolean indicating whether `ncurses/ncurses.h` is available.

`CURSES_HAVE_NCURSES_CURSES_H`

  Boolean indicating whether `ncurses/curses.h` is available.

## Hints

This module accepts the following variables:

`CURSES_NEED_NCURSES`

  Set this variable to `TRUE` before calling `find_package(Curses)` if the the ncurses implementation functionality is specifically required.

`CURSES_NEED_WIDE`

  Added in version 3.10.

  Set this variable to `TRUE` before calling `find_package(Curses)` if Unicode (wide character) support is required.

## Deprecated Variables

The following legacy variables are provided for backward compatibility:

`CURSES_INCLUDE_DIR`

  Deprecated since version 3.1: Use the `CURSES_INCLUDE_DIRS` variable instead.

  Path to a Curses include directory.

`CURSES_LIBRARY`

  Deprecated since version 2.4: Use the `CURSES_LIBRARIES` variable instead.

  Path to Curses library.

## Examples

Finding Curses and creating an imported interface target for linking it to a project target:

    find_package(Curses)
    if(Curses_FOUND AND NOT TARGET Curses::Curses)
      add_library(Curses::Curses INTERFACE IMPORTED)
      set_target_properties(
        Curses::Curses
        PROPERTIES
          INTERFACE_LINK_LIBRARIES "${CURSES_LIBRARIES}"
          INTERFACE_INCLUDE_DIRECTORIES "${CURSES_INCLUDE_DIRS}"
      )
    endif()

    add_executable(app app.c)
    target_link_libraries(app PRIVATE Curses::Curses)

When ncurses is specifically required:

    set(CURSES_NEED_NCURSES TRUE)
    find_package(Curses)