meta(3curses)

meta -- enable/disable meta-keys

Synopsis

cc [options] file -lcurses

#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 termio(7) and ``General terminal interface'' in Programming with system calls and libraries). 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(3curses) returns OK. Otherwise, it returns ERR.

Errors

No errors are defined.

Usage

The same effect is achieved outside Curses using the CS7 or CS8 control mode flag specified on the termio(7) manual page.

The meta(3curses) 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.

Standards Conformance

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

References

``Input Processing'', getch(3curses), curses(4), the description of the ISTRIP flag on termio(7)