erasechar, erasewchar, killchar, and killwchar Subroutine

Purpose

Terminal environment query functions.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

char erasechar(void);

int erasewchar(wchar_t *ch);

char killchar(void);

int killwchar(wchar_t 
*ch);

Description

The erasechar subroutine returns the current character. chosen by the user. The erasechar subroutine stores the current erase character in the object pointed to by the ch parameter. If no erase character has been defined, the subroutine will fail and the object pointed to by ch will not be changed.

The killchar subroutine returns the current line.

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

Return Values

The erasechar subroutine returns the erase character and the killchar subroutine returns the line kill character. The return value is unspecified when these characters are multi-byte characters.

Upon successful completion, the erasechar subroutine and the killchar subroutine return OK. Otherwise, they return ERR.

Examples

To retrieve a user's erase character and return it to the user-defined variable myerase, enter:

myerase = erasechar();