curs_extend(3x)
curses_version, use_extended_names - miscellaneous ncurses extensions
SYNOPSIS
Section titled “SYNOPSIS”#include <curses.h>
DESCRIPTION
Section titled “DESCRIPTION”These ncurses extensions to the curses library do not fit easily into other functional categories.
curses_version
Section titled “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
Section titled “use_extended_names”use_extended_names configures whether the library recognizes user-defined or nonstandard terminfo capability names that may be compiled into terminal type descriptions via the curs_terminfo(3X) or curs_termcap(3X) interfaces. Normally these names are available for use, since the essential decision is made through use of tic(1M)’s -x option to include such extensions in terminal type descriptions. use_extended_names(FALSE) prevents ncurses from recognizing these capabilities to ensure compatibility with other implementations of curses.
RETURN VALUE
Section titled “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.
The pointer returned by curses_version corresponds to statically allocated memory; do not attempt to free(3) it.
EXTENSIONS
Section titled “EXTENSIONS”These functions are ncurses extensions, and are not found in SVr4 curses, 4.4BSD curses, or any other previous curses implementation.
PORTABILITY
Section titled “PORTABILITY”Applications employing ncurses extensions should condition their use on the visibility of the NCURSES_VERSION preprocessor macro.
NetBSD 9 (2020) added a curses_version function that intentionally returns a string devoid of version information.
AUTHORS
Section titled “AUTHORS”Thomas Dickey
SEE ALSO
Section titled “SEE ALSO”ncurses offers several other extensions to the X/Open Curses API.
curs_getch(3X), curs_inopts(3X), curs_mouse(3X), curs_print(3X), curs_util(3X), default_colors(3X), define_key(3X), keybound(3X), keyok(3X), new_pair(3X), resizeterm(3X), wresize(3X)