logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

curses_version, use_extended_names - miscellaneous curses extensions

Authors

       Thomas Dickey

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);

See Also