set_term(3X)                                                   set_term(3X)

NAME
     setterm - switch between screens

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     SCREEN *setterm(SCREEN *new);

DESCRIPTION
     The setterm() function switches between different screens. The new
     argument specifies the new current screen.

RETURN VALUE
     Upon successful completion, setterm() returns a pointer to the previ-
     ous screen. Otherwise, it returns a null pointer.

ERRORS
     No errors are defined.

NOTES
     This is the only function that manipulates SCREEN pointers; all other
     functions affect only the current screen.

SEE ALSO
     curses(3X), initscr(3X), curses(5).




























Page 1                       Reliant UNIX 5.44                Printed 11/98