X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_add_wch.3x.html;h=b33c693e2033b42f4e3644d97046ef105571330f;hp=3e39b081d5880d4a9beb98bb0a952249eeb7142d;hb=5eb177874dea59107a1a2ea44f5d8f5bb99550b2;hpb=b0b1980be11bba618d84beb8b30ac94e2c820602 diff --git a/doc/html/man/curs_add_wch.3x.html b/doc/html/man/curs_add_wch.3x.html index 3e39b081..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 @@ -89,29 +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. - - Line Graphics - Like curs_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 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 @@ -169,8 +171,7 @@ WACS_D_PLUS 0x256c + double large plus or crossover --
+
All routines return the integer ERR upon failure and OK on success. @@ -179,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. @@ -212,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) @@ -221,7 +219,22 @@ curs_add_wch(3x)-