extensions(3NCURSES) Library calls extensions(3NCURSES)
NAME
curses_version, use_extended_names - miscellaneous curses extensions
SYNOPSIS
#include <curses.h>
const char * curses_version(void);
int use_extended_names(bool bf);
DESCRIPTION
These ncurses extensions to the curses library do not fit easily into
other functional categories.
curses_version
curses_version returns a pointer to a string containing the library's
name and version number, including its patch level, for example “ncurses
6.5.20240720”.
use_extended_names
use_extended_names configures whether the library recognizes user-de-
fined or nonstandard terminfo capability names that may be compiled into
terminal type descriptions via the terminfo(3NCURSES) or
termcap(3NCURSES) interfaces. Normally these names are available for
use, since the essential decision is made through use of tic(1)'s -x op-
tion to include such extensions in terminal type descriptions.
use_extended_names can prevent ncurses from recognizing these capabili-
ties to ensure compatibility with other implementations of curses.
RETURN VALUE
curses_version returns a constant string.
use_extended_names returns the previous state of extended capability
name recognition, allowing you to save this property and restore it.
NOTES
The pointer returned by curses_version corresponds to statically allo-
cated memory; do not attempt to free(3) it.
EXTENSIONS
These functions are ncurses extensions, and are not found in SVr4
curses, 4.4BSD curses, or any other previous curses implementation.
PORTABILITY
Applications employing ncurses extensions should condition their use on
the visibility of the NCURSES_VERSION preprocessor macro.
AUTHORS
Thomas Dickey
SEE ALSO
ncurses offers several other extensions to the X/Open Curses API.
getch(3NCURSES), inopts(3NCURSES), mouse(3NCURSES), print(3NCURSES),
util(3NCURSES), default_colors(3NCURSES), define_key(3NCURSES),
keybound(3NCURSES), keyok(3NCURSES), new_pair(3NCURSES),
resizeterm(3NCURSES), wresize(3NCURSES)
ncurses 6.5 2025-01-18 extensions(3NCURSES)
Generated by dwww version 1.16 on Fri Oct 2 22:49:18 CEST 2026.