endwin(3X)                                                       endwin(3X)

NAME
     endwin - suspend Curses session

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

     #include <curses.h>

     int endwin(void);

DESCRIPTION
     The endwin() function restores the terminal after Curses activity by
     at least restoring the saved shell terminal mode, flushing any output
     to the terminal and moving the cursor to the first column of the last
     line of the screen. Refreshing a window resumes program mode. The
     application must call endwin() for each terminal being used before
     exiting. If newterm() is called more than once for the same terminal,
     the first screen created must be the last one for which endwin() is
     called.

RETURN VALUE
     Upon successful completion, endwin() returns OK. Otherwise, it returns
     ERR.

ERRORS
     No errors are defined.

NOTES
     The endwin() function does not free storage associated with a screen,
     so delscreen() should be called after endwin() if a particular screen
     is no longer needed.

     To leave Curses mode temporarily, portable applications should call
     endwin(). Subsequently, to return to Curses mode, they should call
     doupdate(), refresh() or wrefresh().

SEE ALSO
     curses(3X), delscreen(3X), doupdate(3X), initscr(3X), isendwin(3X),
     curses(5).
















Page 1                       Reliant UNIX 5.44                Printed 11/98