X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_add_wch.3x.html;h=b33c693e2033b42f4e3644d97046ef105571330f;hb=8e397cccba0aad135cb9a8a353756f4273a7cdf6;hp=77ed34d591bd0f66543214d40f575af6852e9335;hpb=f86cbeb5f9bd96ab041d34039c35749a14965039;p=ncurses.git diff --git a/doc/html/man/curs_add_wch.3x.html b/doc/html/man/curs_add_wch.3x.html index 77ed34d5..b33c693e 100644 --- a/doc/html/man/curs_add_wch.3x.html +++ b/doc/html/man/curs_add_wch.3x.html @@ -1,7 +1,6 @@ - +
+ +- curs_add_wch(3x) curs_add_wch(3x) --
+
add_wch, wadd_wch, mvadd_wch, mvwadd_wch, echo_wchar, wecho_wchar - add a complex character and rendition to a curses window, then advance the cursor --
+
#include <curses.h> int add_wch( const cchar_t *wch ); @@ -65,8 +63,9 @@ int wecho_wchar( WINDOW *win, const cchar_t *wch ); --
+
+ +
The add_wch, wadd_wch, mvadd_wch, and mvwadd_wch functions put the complex character wch into the given window at its current position, which is then advanced. These functions @@ -77,41 +76,43 @@ ous character at that location is removed. A new character specified by wch is placed at that location with rendition specified by wch. The cursor then - advances to the next spacing character on the screen. + advances to the next spacing character on the screen. o If wch refers to a non-spacing character, all previous - characters at that location are preserved. The non- - spacing characters of wch are added to the spacing - complex character, and the rendition specified by wch + characters at that location are preserved. The non- + spacing characters of wch are added to the spacing + complex character, and the rendition specified by wch is ignored. - o If the character part of wch is a tab, newline, - backspace or other control character, the window is - updated and the cursor moves as if addch were called. + o If the character part of wch is a tab, newline, + backspace or other control character, the window is + updated and the cursor moves as if addch were called. + +
The echo_wchar function is functionally equivalent to a - call to add_wch followed by a call to refresh. Similarly, - the wecho_wchar is functionally equivalent to a call to - wadd_wch followed by a call to wrefresh. The knowledge - that only a single character is being output is taken into - consideration and, for non-control characters, a consider- - able performance gain might be seen by using the *echo* - functions instead of their equivalents. - - Line Graphics - Like addch(3x), addch_wch accepts symbols which make it + call to add_wch followed by a call to refresh(3x). Simi- + larly, the wecho_wchar is functionally equivalent to a + call to wadd_wch followed by a call to wrefresh. The + knowledge that only a single character is being output is + taken into consideration and, for non-control characters, + a considerable performance gain might be seen by using the + *echo* functions instead of their equivalents. + + +
+ Like addch(3x), addch_wch accepts symbols which make it simple to draw lines and other frequently used special characters. These symbols correspond to the same VT100 - line-drawing set as addch(3x). - + line-drawing set as addch(3x). Name Unicode Default Description ---------------------------------------------------------------- WACS_BLOCK 0x25ae # solid square block WACS_BOARD 0x2592 # board of squares WACS_BTEE 0x2534 + bottom tee - WACS_BULLET 0x00b7 o bullet + WACS_BULLET 0x00b7 o bullet WACS_CKBOARD 0x2592 : checker board (stipple) WACS_DARROW 0x2193 v arrow pointing down WACS_DEGREE 0x00b0 ' degree symbol @@ -144,7 +145,6 @@ The wide-character configuration of ncurses also defines symbols for thick- and double-lines: - Name Unicode Default Description --------------------------------------------------------------------- WACS_T_ULCORNER 0x250f + thick upper left corner @@ -171,8 +171,7 @@ WACS_D_PLUS 0x256c + double large plus or crossover --
+
All routines return the integer ERR upon failure and OK on success. @@ -181,14 +180,12 @@ outside the window, or if the window pointer is null. --
+
Note that add_wch, mvadd_wch, mvwadd_wch, and echo_wchar may be macros. --
+
All of these functions are described in the XSI Curses standard, Issue 4. The defaults specified for line-draw- ing characters apply in the POSIX locale. @@ -214,19 +211,30 @@ definitions which are not in the SVr4 implementations. --
+
curses(3x), curs_addch(3x), curs_attr(3x), curs_clear(3x), - curs_outopts(3x), curs_refresh(3x), putwc(3) + curs_outopts(3x), curs_refresh(3x), putwc(3) curs_add_wch(3x)-