opensolaris man page for set_term

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 subse-
       quent 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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       libcurses(3XCURSES), attributes(5), standards(5)

SunOS 5.11							    5 Jun 2002							set_term(3XCURSES)