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();

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The clearok, delscreen, and tcgetattr subroutines.

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Portability with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs describes how to query baud rate, set user-defined characters, and flush type-ahead characters.