# curs_extend 3x

    curs_extend(3x)                                                curs_extend(3x)

## NAME

           curses_version, use_extended_names - miscellaneous curses extensions

## SYNOPSIS

           #include <curses.h>

           const char * curses_version(void);
           int use_extended_names(bool enable);

## DESCRIPTION

           These  functions  are extensions to the curses library which do not fit
           easily into other categories.

### curses_version

           Use curses_version to get the version number, including patch level  of
           the library, e.g., 5.0.19991023

### use_extended_names

           The  use_extended_names  function controls whether the calling applica-
           tion is able to use user-defined or nonstandard names which may be com-
           piled  into the terminfo description, i.e., via the terminfo or termcap
           interfaces.  Normally these names are  available  for  use,  since  the
           essential  decision  is  made  by using the -x option of tic to compile
           extended terminal definitions.  However you can disable this feature to
           ensure compatibility with other implementations of curses.

## RETURN VALUE

           curses_version  returns a pointer to static memory; you should not free
           this in your application.

           use_extended_names returns the previous state,  allowing  you  to  save
           this and restore it.

## PORTABILITY

           These  routines  are  specific  to ncurses.  They were not supported on
           Version 7, BSD or System V implementations.  It is recommended that any
           code depending on them be conditioned using NCURSES_VERSION.

## SEE ALSO

           curs_getch(3x),    curs_mouse(3x),    curs_print(3x),    curs_util(3x),
           default_colors(3x),    define_key(3x),     keybound(3x),     keyok(3x),
           resizeterm(3x), wresize(3x).

## AUTHOR

           Thomas Dickey.

                                                                   curs_extend(3x)