endwin.3x (2010 09)

e
endwin(3X) endwin(3X)
(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 termi-
nal, 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(3X), doupdate(3X), initscr(3X), isendwin(3X), <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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1