[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , Volume 2


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 doupdate (doupdate, refresh, wnoutrefresh, or wrefresh Subroutines) subroutine, initscr (initscr and newterm Subroutine) subroutine, and isendwin subroutine.

Curses Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

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

Starting and Stopping Curses in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]