Technical Reference: Base Operating System and Extensions , Volume 2

set_term Subroutine

Purpose

Switches between screens.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>
 
SCREEN *set_term
(SCREEN *new);

Description

The set_term subroutine switches between different screens. The new argument specifies the current screen.

Parameters

Return Values

Upon successful completion, the set_term subroutine returns a pointer to the previous screen. Otherwise, it returns a null pointer.

Examples

To make the terminal stored in the user-defined SCREEN variable my_terminal the current terminal and then store a pointer to the old terminal in the user-defined variable old_terminal, enter:

SCREEN *old_terminal, *my_terminal;
old_terminal = set_term(my_terminal);

Implementation Specifics

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

Related Information

The initscr (initscr and newterm Subroutine) subroutine, newterm (newterm 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.

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