endwin Subroutine

Purpose

Suspends curses session.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int endwin(void)

Description

The endwin subroutine 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 the endwin subroutine for each terminal being used before exiting. If the newterm subroutine is called more than once for the same terminal, the first screen created must be the last one for which the endwin subroutine is called.

Return Values

Upon successful completion, the endwin subroutine returns OK. Otherwise, it returns ERR.

Examples

To terminate curses permanently or temporarily, enter:

endwin();

Implementation Specifics

The endwin subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The delscreen, doupdate, initscr, and isendwin subroutines.

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Starting and Stopping Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.