meta(3X)                                                           meta(3X)

NAME
     meta - enable/disable meta-keys

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #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 the
     XBD 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(4) 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.

NOTES
     The same effect is achieved outside Curses using the CS7 or CS8 con-
     trol mode flag specified in the XBD 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
     curses(3X), getch(3X), terminfo(4), curses(5).

















Page 1                       Reliant UNIX 5.44                Printed 11/98