meta(3X)

ENHANCED CURSES

NAME

meta — enable/disable meta-keys

SYNOPSIS

#include <curses.h>

int meta(WINDOW *win, bool bf);

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.

CHANGE HISTORY

First released in X/Open Curses, Issue 4.

Hewlett-Packard Company — HP-UX Release 10.20: July 1996

Museum