Technical Reference: Base Operating System and Extensions , Volume 2

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 (derwin, newwin, or subwin Subroutine) 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.

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