HPlogo HP-UX Reference > S

set_term(3X)

CURSES
HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

NAME

set_term() — switch between screens

SYNOPSIS

#include <curses.h>

SCREEN *set_term(SCREEN *new);

DESCRIPTION

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

RETURN VALUE

Upon successful completion, set_term() returns a pointer to the previous screen. Otherwise, it returns a null pointer.

ERRORS

No errors are defined.

APPLICATION USAGE

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

SEE ALSO

initscr(3X), curses_intro(3X), see Screens, Windows and Terminals, <curses.h>.

CHANGE HISTORY

First released in X/Open Curses, Issue 2.

X/Open Curses, Issue 4

The entry is rewritten for clarity.