erasechar(3X)                                                 erasechar(3X)

NAME
     erasechar, erasewchar, killchar, killwchar - terminal environment
     query functions

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     char erasechar(void);

     int erasewchar(wchart *ch);

     char killchar(void);

     int killwchar(wchart *ch);

DESCRIPTION
     The erasechar() function returns the current erase character. The
     erasewchar() function stores the current erase character in the object
     pointed to by ch. If no erase character has been defined, the function
     will fail and the object pointed to by ch will not be changed.

     The killchar() function returns the current line kill character. The
     killwchar() function stores the current line kill character in the
     object pointed to by ch. If no line kill character has been defined,
     the function will fail and the object pointed to by ch will not be
     changed.

RETURN VALUE
     The erasechar() function returns the erase character and killchar()
     returns the line kill character. The return value is unspecified when
     these characters are multi-byte characters.

     Upon successful completion, erasewchar() and killwchar() return OK.
     Otherwise, they return ERR.

ERRORS
     No errors are defined.

NOTES
     The erasechar() and killchar() functions are only guaranteed to
     operate reliably on character sets in which each character fits into a
     single byte, whose attributes can be expressed using only constants
     with the A prefix. Moreover, they do not reliably indicate cases in
     which the erase or line kill character, respectively, has not been
     defined. The erasewchar() and killwchar() functions overcome these
     limitations.

SEE ALSO
     tcgetattr(2), clearok(3X), curses(3X), delscreen(3X), curses(5).




Page 1                       Reliant UNIX 5.44                Printed 11/98