man pages section 3: Curses Library Functions

set_term(3XCURSES)

Name

set_term - switch between terminals

Synopsis

cc [ flag... ] file... –I /usr/xpg4/include –L /usr/xpg4/lib \
–R /usr/xpg4/lib –lcurses [ library... ]

c89 [ flag... ] file... –lcurses [ library... ]

#include <curses.h>

SCREEN *set_term(SCREEN *new);

Parameters

new

Is the new terminal to which the set_term() function will switch.

Description

The set_term() function switches to the terminal specified by new and returns a screen reference to the previous terminal. Calls to subsequent X/Open Curses functions affect the new terminal.

Return Values

On success, the set_term() function returns a pointer to the previous screen. Otherwise, it returns a null pointer.

Errors

None.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Unsafe Standard See standards(7).

See Also

libcurses(3XCURSES), attributes(7), standards(7)