termattrs(3NCURSES) Library calls termattrs(3NCURSES)
NAME
baudrate, erasechar, erasewchar, has_ic, has_il, killchar, killwchar,
longname, term_attrs, termattrs, termname - get and set terminal attrib-
utes with curses
SYNOPSIS
#include <curses.h>
int baudrate(void);
char erasechar(void);
int erasewchar(wchar_t * wc);
bool has_ic(void);
bool has_il(void);
char killchar(void);
int killwchar(wchar_t * wc);
char * longname(void);
attr_t term_attrs(void);
chtype termattrs(void);
char * termname(void);
DESCRIPTION
baudrate
baudrate returns the line speed of the terminal, an integer value mea-
sured in bits per second, for example 9600.
erasechar, erasewchar
erasechar returns the terminal's erase character.
erasewchar stores the erase character in the location referenced by wc.
If no erase character has been defined, it fails and the location refer-
enced by wc is not changed.
has_ic, has_il
has_ic returns TRUE if the terminal has insert- and delete-character ca-
pabilities.
has_il returns TRUE if the terminal has insert- and delete-line capabil-
ities, or can simulate them using scrolling regions. It might be used
to determine whether it would be appropriate to use scrollok(3NCURSES)
to turn on scrolling.
killchar, killwchar
killchar returns the terminal's line kill character.
killwchar stores the line-kill character in the location referenced by
wc. If no line-kill character has been defined, it fails and the loca-
tion referenced by wc is not changed.
longname
longname returns a pointer to static storage containing a verbose de-
scription of the terminal being managed by curses. The maximum length
of a verbose description is 128 characters. The storage is populated
only after initscr(3NCURSES) or newterm(3NCURSES) is called. This stor-
age is overwritten by each call to newterm and not restored by
set_term(3NSES), so its contents should be saved between calls to
initscr or newterm if longname is to be used with multiple terminals.
termattrs, term_attrs
If a given terminal does not support a video attribute that an applica-
tion program is trying to use, curses may substitute a different video
attribute for it. termattrs and term_attrs return a logical “or” of all
video attributes supported by the terminal using A_ and WA_ constants
respectively. This information is useful when a curses program needs
complete control over the appearance of the screen.
termname
termname returns the terminal name used by setupterm(3NCURSES).
RETURN VALUE
longname and termname return NULL on error.
Functions that return an integer return ERR upon failure and OK upon
success.
NOTES
erasewchar, killwchar, and term_attrs are part of ncurses's wide-charac-
ter API, and are not available in its non-wide configuration.
termattrs may be implemented as a macro.
PORTABILITY
X/Open Curses Issue 4 describes these functions.
SVr4 describes a successful return value only as “an integer value other
than ERR”.
Most versions of curses truncate the string returned by termname to 14
characters.
HISTORY
4BSD (1980) introduced longname.
SVr2 (1984) added baudrate, erasechar, killchar, has_ic, and has_il.
SVr3 (1987) supplied termname. Later that year, SVr3.1 brought
termattrs.
X/Open Curses Issue 4 (1995) specified erasewchar, killwchar, and
term_attrs.
SEE ALSO
ncurses(3NCURSES), initscr(3NCURSES), outopts(3NCURSES)
ncurses 6.5 2025-02-01 termattrs(3NCURSES)
Generated by dwww version 1.16 on Sat Oct 3 05:07:48 CEST 2026.