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 subroutine, newterm 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.

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