meta Subroutine

Purpose

Enables/disables meta-keys.

Library

Curses Library (libcurses.a)

Syntax

#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. 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

Return Values

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

Examples

1. To request an 8-bit character return when using a getch routine, enter:

   WINDOW *some_window;
   meta(some_window, TRUE);

2. 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 subroutine.

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

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

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