[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 2

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

bf
*win

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.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]