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

Item Description
*win Specifies the window to delete.

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);