SET_TERM(3XCURSES) X/Open 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 | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO

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

June 5, 2002 SET_TERM(3XCURSES)