Technical Reference: Base Operating System and Extensions , Volume 2

meta Subroutine

Syntax

#include <curses.h>
 
int meta(WINDOW *win,
bool bf);

Initially, whether the terminal returns 7 or 8 significant bits on input depends on the control mode of the display driver. To force 8 bits to be returned, invoke the meta subroutine (win, TRUE). To force 7 bits to be returned, invoke the meta subroutine (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.

Parameters

bf
*win

Return Values

Upon successful completion, the meta subroutine returns OK. Otherwise, it returns ERR.

Examples

To request an 8-bit character return when using a getch routine, enter:
```
WINDOW *some_window;
meta(some_window, TRUE);
```
To strip the highest bit off the character returns in the user-defined window my_window, enter:
```
WINDOW *some_window;
meta(some_window, FALSE);
```

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The getch (getch, mvgetch, mvwgetch, or wgetch Subroutine) subroutine.

Curses Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

Manipulating Characters with Curses in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.