erasechar(CURSES)

erasechar -- terminal environment query functions

Synopsis

cc [options] file -lcurses

#include <curses.h>

char erasechar(void);

int erasewchar(wchar_t *ch);

char killchar(void);

int killwchar(wchar_t *ch);

Description

The erasechar(CURSES) function returns the current erase character. The erasewchar(CURSES) 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(CURSES) function returns the current line kill character. The killwchar(CURSES) 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(CURSES) function returns the erase character and killchar(CURSES) returns the line kill character. The return value is unspecified when these characters are multi-byte characters.

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

Errors

No errors are defined.

Usage

The erasechar(CURSES) and killchar(CURSES) 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 when the erase or line kill character, respectively, has not been defined. The erasewchar(CURSES) and killwchar(CURSES) functions overcome these limitations.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

``Attributes'', clearok(CURSES), delscreen(CURSES), tcgetattr(S), curses(F)