curses_version, use_extended_names - miscellaneous curses extensions
Contents
Description
These ncurses extensions to the curses library do not fit easily into other functional categories.
curses_versioncurses_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_namesuse_extended_names configures whether the library recognizes user-defined 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 option to include such extensions in terminal type descriptions.
use_extended_names can prevent ncurses from recognizing these capabilities to ensure compatibility with
other implementations of curses.
Extensions
These functions are ncurses extensions, and are not found in SVr4 curses, 4.4BSD curses, or any other
previous curses implementation.
Name
curses_version, use_extended_names - miscellaneous curses extensions
Notes
The pointer returned by curses_version corresponds to statically allocated memory; do not attempt to
free(3) it.
Portability
Applications employing ncurses extensions should condition their use on the visibility of the
NCURSES_VERSION preprocessor macro.
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.
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)
Synopsis
#include<curses.h>constchar*curses_version(void);intuse_extended_names(boolbf);
