X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_add_wch.3x.html;h=66360113e7faa25840d5591b39353835d82c3a58;hb=2a32bee362db64f5a06b2124976b928ac3faa578;hp=5c22236d837e5f3e5b071d68aa3de88577674cf8;hpb=761e4f0825b330e970558e82a4bd638383914429;p=ncurses.git diff --git a/doc/html/man/curs_add_wch.3x.html b/doc/html/man/curs_add_wch.3x.html index 5c22236d..66360113 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,6 +88,8 @@ 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 @@ -98,20 +99,21 @@ 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 + +
+ Like curs_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 curs_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,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)-