curs_termattrs(3X) LIBRARY FUNCTIONS curs_termattrs(3X)
NAME
curstermattrs: baudrate, erasechar, hasic, hasil,
killchar, longname, termattrs, termname - curses environment
query routines
SYNOPSIS
#include <curses.h>
int baudrate(void);
char erasechar(void);
int hasic(void);
int hasil(void);
char killchar(void);
char *longname(void);
chtype termattrs(void);
char *termname(void);
DESCRIPTION
The baudrate routine returns the output speed of the termi-
nal. The number returned is in bits per second, for example
9600, and is an integer. With the erasechar routine, the
user's current erase character is returned. The hasic rou-
tine is true if the terminal has insert- and delete-
character capabilities. The hasil routine is true if the
terminal has insert- and delete-line capabilities, or can
simulate them using scrolling regions. This might be used
to determine if it would be appropriate to turn on physical
scrolling using scrollok. With the killchar routine, the
user's current line kill character is returned. The long-
name routine returns a pointer to a static area containing a
verbose description of the current terminal. The maximum
length of a verbose description is 128 characters. It is
defined only after the call to initscr or newterm. The area
is overwritten by each call to newterm and is not restored
by setterm, so the value should be saved between calls to
newterm if longname is going to be used with multiple termi-
nals. If a given terminal doesn't support a video attribute
that an application program is trying to use, curses may
substitute a different video attribute for it. The ter-
mattrs function returns a logical OR of all video attributes
supported by the terminal. This information is useful when
a curses program needs complete control over the appearance
of the screen. The termname routine returns the value of
the environmental variable TERM (truncated to 14 charac-
ters).
RETURN VALUE
longname and termname return NULL on error.
Routines that return an integer return ERR upon failure and
an integer value other than ERR upon successful completion.
1
curs_termattrs(3X) LIBRARY FUNCTIONS curs_termattrs(3X)
NOTES
The header file <curses.h> automatically includes the header
files <stdio.h> and <unctrl.h>.
Note that termattrs may be a macro.
SEE ALSO
curses(3X), cursinitscr(3X), cursoutopts(3X).
2