1meta(3XCURSES)          X/Open Curses Library Functions         meta(3XCURSES)
2
3
4

NAME

6       meta - enable/disable meta keys
7

SYNOPSIS

9       cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
10        -R  /usr/xpg4/lib  -lcurses  [ library... ]
11
12       c89 [ flag... ] file... -lcurses [ library... ]
13
14       #include <curses.h>
15
16       int meta(WINDOW *win, bool bf);
17
18

PARAMETERS

20       win    Is an ignored parameter.
21
22
23       bf     Is a Boolean expression.
24
25

DESCRIPTION

27       Whether a terminal returns 7 or 8 significant bits initially depends on
28       the  control mode of the terminal driver.  The meta()  function  forces
29       the number of bits to be returned by  getch(3XCURSES) to be 7 (if bf is
30       FALSE) or 8 (if bf is  TRUE).
31
32
33       If the program handling the data can  only  pass  7-bit  characters  or
34       strips the 8th bit, 8 bits cannot be handled.
35
36
37       If  the  terminfo  capabilities  smm  (meta_on)  and rmm (meta_off) are
38       defined for the terminal, smm is sent to the terminal   when  meta(win,
39       TRUE) is called, and rmm is sent when meta(win, FALSE) is called.
40
41
42       This  function  is  useful  when  extending the non-text command set in
43       applications where the META key is used.
44

RETURN VALUES

46       On success, the meta() function returns OK. Otherwise, it returns ERR.
47

ERRORS

49       None.
50

ATTRIBUTES

52       See attributes(5) for descriptions of the following attributes:
53
54
55
56
57       ┌─────────────────────────────┬─────────────────────────────┐
58       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
59       ├─────────────────────────────┼─────────────────────────────┤
60       │Interface Stability          │Standard                     │
61       ├─────────────────────────────┼─────────────────────────────┤
62       │MT-Level                     │Unsafe                       │
63       └─────────────────────────────┴─────────────────────────────┘
64

SEE ALSO

66       getch(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)
67
68
69
70SunOS 5.11                        5 Jun 2002                    meta(3XCURSES)
Impressum