meta(3X)

DESCRIPTION

Initially, whether the terminal returns 7 or 8 significant bits on input depends on the control mode of the display driver (see the X/Open System Interface Definitions, Issue 4, Version 2 specification, General Terminal Interface). To force 8 bits to be returned, invoke meta(win, TRUE). To force 7 bits to be returned, invoke meta(win, FALSE). The win argument is always ignored. If the terminfo capabilities smm (meta_on) and rmm (meta_off) are defined for the terminal, smm is sent to the terminal when meta(win, TRUE) is called and rmm is sent when meta(win, FALSE) is called.

RETURN VALUE

Upon successful completion, meta() returns OK. Otherwise, it returns ERR.

ERRORS

No errors are defined.

APPLICATION USAGE

The same effect is achieved outside Curses using the CS7 or CS8 control mode flag specified in the X/Open System Interface Definitions, Issue 4, Version 2 specification ( General Terminal Interface).

The meta() function was designed for use with terminals with 7-bit character sets and a ``meta'' key that could be used to set the eighth bit.

SEE ALSO

getch(3X), curses_intro(3X), see subsection Input Processing, <curses.h>, X/Open System Interface Definitions, Issue 4, Version 2 specification, Section 9.2, Parameters That Can Be Set (ISTRIP flag).

CHANGE HISTORY

First released in X/Open Curses, Issue 4.