CURSES

NAME

endwin — suspend Curses session

SYNOPSIS

#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. 

APPLICATION USAGE

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

delscreen(), doupdate(), initscr(), isendwin(), <curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 2. 

X/Open Curses, Issue 4

The entry is rewritten for clarity.  The argument list is explicitly declared as void. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996