delwin Subroutine

Purpose

Deletes a window.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int delwin(WINDOW *win);

Description

The delwin subroutine deletes win, freeing all memory associated with it. The application must delete subwindows before deleting the main window.

Parameters

Return Values

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

Examples

To delete the user-defined window my_window and its subwindow my_sub_window, enter:

WINDOW *my_sub_window, *my_window;
delwin(my_sub_window);

delwin(my_window);

Implementation Specifics

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

Related Information

The derwin and dupwin 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.

Manipulating Window Data with Curses in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.