X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fman%2Fcurs_add_wch.3x.html;h=b33c693e2033b42f4e3644d97046ef105571330f;hb=f344f8539c1543f8cd65a5bb142dbaf23b9421d2;hp=1d0115afd589e026ba3848ba18af726b7e9e4030;hpb=c6cfd97b8beaf0f6deafbf8aac7281cf6aa7f012;p=ncurses.git diff --git a/doc/html/man/curs_add_wch.3x.html b/doc/html/man/curs_add_wch.3x.html index 1d0115af..b33c693e 100644 --- a/doc/html/man/curs_add_wch.3x.html +++ b/doc/html/man/curs_add_wch.3x.html @@ -1,6 +1,6 @@ @@ -38,23 +38,20 @@
-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 ); @@ -66,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 @@ -90,31 +88,32 @@ 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. + 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 curs_addch(3x), addch_wch accepts symbols which make it +
+ 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 curs_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_CKBOARD 0x2592 : checker board (stipple) - WACS_DARROW 0x2193 v arrow pointing down WACS_DEGREE 0x00b0 ' degree symbol WACS_DIAMOND 0x25c6 + diamond @@ -172,8 +171,7 @@ WACS_D_PLUS 0x256c + double large plus or crossover --
+
All routines return the integer ERR upon failure and OK on success. @@ -182,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. @@ -215,8 +211,7 @@ 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) @@ -230,6 +225,8 @@