clear(3X)

CURSES

NAME

clear, erase, wclear, werase — clear a window

SYNOPSIS

#include <curses.h>

int clear(void);

int erase(void);

int wclear(WINDOW *win);

int werase(WINDOW *win);

DESCRIPTION

The clear(), erase(), wclear() and werase() functions clear every position in the current or specified window.

The clear() and wclear() functions also achieve the same effect as calling clearok() so that the window is cleared completely on the next call to wrefresh() for the window and is redrawn in its entirety.

RETURN VALUE

Upon successful completion, these functions return OK. Otherwise, they return ERR.

ERRORS

No errors are defined.

CHANGE HISTORY

First released in X/Open Curses, Issue 2.

X/Open Curses, Issue 4

The erase() and werase() functions are merged with this entry. In previous issues, they appeared in entries of their own.

The entry is rewritten for clarity. The argument list for the clear() and erase() functions is explicitly declared as void.

Hewlett-Packard Company — HP-UX Release 10.20: July 1996

Museum