# curs_termattrs 3x

    curs_termattrs(3x)                                   curs_termattrs(3x)

## NAME

           baudrate, erasechar, erasewchar, has_ic, has_il, killchar,
           killwchar, longname,  term_attrs,  termattrs,  termname  -
           curses environment query routines

## SYNOPSIS

           #include <curses.h>

           int baudrate(void);
           char erasechar(void);
           int erasewchar(wchar_t *ch);
           bool has_ic(void);
           bool has_il(void);
           char killchar(void);
           int killwchar(wchar_t *ch);
           char *longname(void);
           attr_t term_attrs(void);
           chtype termattrs(void);
           char *termname(void);

## DESCRIPTION

           The  baudrate routine returns the output speed of the ter-
           minal.  The number returned is in  bits  per  second,  for
           example 9600, and is an integer.

           The  erasechar  routine  returns  the user's current erase
           character.

           The erasewchar routine stores the current erase  character
           in  the  location referenced by ch.  If no erase character
           has been defined, the routine fails and the location  ref-
           erenced by ch is not changed.

           The has_ic routine is true if the terminal has insert- and
           delete- character capabilities.

           The has_il 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.

           The killchar routine returns the user's current line  kill
           character.

           The killwchar routine stores the current line-kill charac-
           ter in the location referenced by  ch.   If  no  line-kill
           character  has  been  defined,  the  routine fails and the
           location referenced by ch is not changed.

           The longname 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 charac-
           ters.   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 set_term, so the value should be
           saved between calls to newterm if longname is going to  be
           used with multiple terminals.

           If  a  given  terminal  does not support a video attribute
           that an application program is trying to use,  curses  may
           substitute  a  different  video  attribute  for  it.   The
           termattrs and term_attrs functions return a logical OR  of
           all  video  attributes  supported by the terminal using A_
           and WA_ constants respectively.  This information is  use-
           ful  when a curses program needs complete control over the
           appearance of the screen.

           The termname routine returns the  terminal  name  used  by
           setupterm.

## RETURN VALUE

           longname and termname return NULL on error.

           Routines  that  return  an integer return ERR upon failure
           and OK (SVr4 only specifies "an integer value  other  than
           ERR") upon successful completion.

## NOTES

           Note that termattrs may be a macro.

## PORTABILITY

           The  XSI  Curses  standard,  Issue 4 describes these func-
           tions.  It changes the return type of termattrs to the new
           type  attr_t.  Most versions of curses truncate the result
           returned by termname to 14 characters.

## SEE ALSO

           curses(3x), curs_initscr(3x), curs_outopts(3x)

                                                         curs_termattrs(3x)