2 .\" Copyright 1989 AT&T
3 .\" Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7 .TH CURS_CLEAR 3CURSES "Dec 31, 1996"
9 curs_clear, erase, werase, clear, wclear, clrtobot, wclrtobot, clrtoeol,
10 wclrtoeol \- clear all or part of a curses window
14 \fBcc\fR [ \fIflag\fR... ] \fIfile\fR ... \fB-lcurses\fR [ \fIlibrary\fR ... ]
17 \fBint\fR \fBerase\fR(\fBvoid\fR);
22 \fBint\fR \fBwerase\fR(\fBWINDOW *\fR\fIwin\fR);
27 \fBint\fR \fBclear\fR(\fBvoid\fR);
32 \fBint\fR \fBwclear\fR(\fBWINDOW *\fR\fIwin\fR);
37 \fBint\fR \fBclrtobot\fR(\fBvoid\fR);
42 \fBint\fR \fBwclrtobot\fR(\fBWINDOW *\fR\fIwin\fR);
47 \fBint\fR \fBclrtoeol\fR(\fBvoid\fR);
52 \fBint\fR \fBwclrtoeol\fR(\fBWINDOW *\fR\fIwin\fR);
58 The \fBerase()\fR and \fBwerase()\fR routines copy blanks to every position in
62 The \fBclear()\fR and \fBwclear()\fR routines are like \fBerase()\fR and
63 \fBwerase()\fR, but they also call \fBclearok()\fR \fB,\fR so that the screen
64 is cleared completely on the next call to \fBwrefresh()\fR for that window and
65 repainted from scratch.
68 The \fBclrtobot()\fR and \fBwclrtobot()\fR routines erase all lines below the
69 cursor in the window. Also, the current line to the right of the cursor,
73 The \fBclrtoeol()\fR and \fBwclrtoeol()\fR routines erase the current line to
74 the right of the cursor, inclusive.
78 All routines return the integer \fBOK\fR, or a non-negative integer if
79 \fBimmedok()\fR is set. See \fBcurs_outopts\fR(3CURSES).
83 See \fBattributes\fR(5) for descriptions of the following attributes:
91 ATTRIBUTE TYPE ATTRIBUTE VALUE
99 \fBcurs_outopts\fR(3CURSES), \fBcurs_refresh\fR(3CURSES),
100 \fBcurses\fR(3CURSES), \fBattributes\fR(5)
104 The header <\fBcurses.h\fR> automatically includes the headers <\fBstdio.h\fR>
105 and <\fBunctrl.h\fR>.
108 Note that \fBerase()\fR, \fBwerase()\fR, \fBclear()\fR, \fBwclear()\fR,
109 \fBclrtobot()\fR, and \fBclrtoeol()\fR may be macros.