X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_clear.3x.html;h=a6e944107774bd487d039104273707d5edde13ff;hb=f9994a48d2f74b613a0adb19d3917f724d4d1312;hp=237d4a27c4548cc3eeb512623b2c944f1a0b4e4d;hpb=c3b21f65a2687f3894a0d3217006c23f162c893a;p=ncurses.git diff --git a/doc/html/man/curs_clear.3x.html b/doc/html/man/curs_clear.3x.html index 237d4a27..a6e94410 100644 --- a/doc/html/man/curs_clear.3x.html +++ b/doc/html/man/curs_clear.3x.html @@ -1,6 +1,7 @@ -
- +-curs_clear(3x) curs_clear(3x) +curs_clear(3x) curs_clear(3x)
- erase, werase, clear, wclear, clrtobot, wclrtobot, - clrtoeol, wclrtoeol - clear all or part of a curses window + erase, werase, clear, wclear, clrtobot, wclrtobot, clrtoeol, wclrtoeol + - clear all or part of a curses window
- # include <curses.h> + #include <curses.h> int erase(void); - int werase(WINDOW *win); + int werase(WINDOW *win); + int clear(void); - int wclear(WINDOW *win); + int wclear(WINDOW *win); + int clrtobot(void); - int wclrtobot(WINDOW *win); + int wclrtobot(WINDOW *win); + int clrtoeol(void); - int wclrtoeol(WINDOW *win); + int wclrtoeol(WINDOW *win);
- The erase and werase routines copy blanks to every posi- - tion in the window, clearing the screen. + The erase and werase routines copy blanks to every position in the win- + dow, clearing the screen. - The clear and wclear routines are like erase and werase, - but they also call clearok, so that the screen is cleared - completely on the next call to wrefresh for that window - and repainted from scratch. + The clear and wclear routines are like erase and werase, but they also + call clearok, so that the screen is cleared completely on the next call + to wrefresh for that window and repainted from scratch. - The clrtobot and wclrtobot routines erase from the cursor - to the end of screen. That is, they erase all lines below - the cursor in the window. Also, the current line to the - right of the cursor, inclusive, is erased. + The clrtobot and wclrtobot routines erase from the cursor to the end of + screen. That is, they erase all lines below the cursor in the window. + Also, the current line to the right of the cursor, inclusive, is + erased. - The clrtoeol and wclrtoeol routines erase the current line - to the right of the cursor, inclusive, to the end of the - current line. + The clrtoeol and wclrtoeol routines erase the current line to the right + of the cursor, inclusive, to the end of the current line. - Blanks created by erasure have the current background ren- - dition (as set by wbkgdset) merged into them. + Blanks created by erasure have the current background rendition (as set + by wbkgdset) merged into them.
- All routines return the integer OK on success and ERR on - failure. The SVr4.0 manual says "or a non-negative inte- - ger if immedok is set", but this appears to be an error. + All routines return the integer OK on success and ERR on failure. - X/Open defines no error conditions. In this implementa- - tion, functions using a window pointer parameter return an - error if it is null. + X/Open defines no error conditions. In this implementation, + + o functions using a window pointer parameter return an error if it is + null + + o wclrtoeol returns an error if the cursor position is about to wrap.
- Note that erase, werase, clear, wclear, clrtobot, and clr- - toeol may be macros. + Note that erase, werase, clear, wclear, clrtobot, and clrtoeol may be + macros.
- These functions are described in the XSI Curses standard, - Issue 4. The standard specifies that they return ERR on - failure, but specifies no error conditions. + These functions are described in the XSI Curses standard, Issue 4. The + standard specifies that they return ERR on failure, but specifies no + error conditions. + + The SVr4.0 manual says that these functions could return "a non-nega- + tive integer if immedok is set", referring to the return-value of wre- + fresh. In that implementation, wrefresh would return a count of the + number of characters written to the terminal. - Some historic curses implementations had, as an undocu- - mented feature, the ability to do the equivalent of - clearok(..., 1) by saying touchwin(stdscr) or clear(std- - scr). This will not work under ncurses. + Some historic curses implementations had, as an undocumented feature, + the ability to do the equivalent of clearok(..., 1) by saying touch- + win(stdscr) or clear(stdscr). This will not work under ncurses. - This implementation, and others such as Solaris, sets the - current position to 0,0 after erasing via werase and - wclear. That fact is not documented in other implementa- - tions, and may not be true of implementations which were - not derived from SVr4 source. + This implementation, and others such as Solaris, sets the current posi- + tion to 0,0 after erasing via werase and wclear. That fact is not doc- + umented in other implementations, and may not be true of implementa- + tions which were not derived from SVr4 source. - Not obvious from the description, most implementations - clear the screen after wclear even for a subwindow or de- - rived window. If you do not want to clear the screen dur- - ing the next wrefresh, use werase instead. + Not obvious from the description, most implementations clear the screen + after wclear even for a subwindow or derived window. If you do not + want to clear the screen during the next wrefresh, use werase instead.
- curses(3x), curs_outopts(3x), curs_refresh(3x), curs_vari- - ables(3x) + curses(3x), curs_outopts(3x), curs_refresh(3x), curs_variables(3x) - curs_clear(3x) + curs_clear(3x)