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);