mojave man page for mvadd_wch

Query: mvadd_wch

OS: mojave

Section: 3x

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

curs_add_wch(3X)														  curs_add_wch(3X)

NAME
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
SYNOPSIS
#include <curses.h> int add_wch( const cchar_t *wch ); int wadd_wch( WINDOW *win, const cchar_t *wch ); int mvadd_wch( int y, int x, const cchar_t *wch ); int mvwadd_wch( WINDOW *win, int y, int x, const cchar_t *wch ); int echo_wchar( const cchar_t *wch ); int wecho_wchar( WINDOW *win, const cchar_t *wch );
DESCRIPTION
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 perform wrapping and special-character processing as follows: - If wch refers to a spacing character, then any previous 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. - 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 is ignored. - 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 func- tionally 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.
RETURN VALUES
All routines return the integer ERR upon failure and OK on success.
NOTES
Note that add_wch, mvadd_wch, mvwadd_wch, and echo_wchar may be macros.
PORTABILITY
All these functions are described in the XSI Curses standard, Issue 4. The defaults specified for forms-drawing characters apply in the POSIX locale. XSI documents constants beginning with WACS_ which are used for line-drawing. Those are not currently implemented in ncurses.
SEE ALSO
curses(3X), curs_addch(3X), curs_attr(3X), curs_clear(3X), curs_outopts(3X), curs_refresh(3X), putwc(3) curs_add_wch(3X)
Related Man Pages
wadd_wch(3x) - mojave
add_wch(3x) - redhat
add_wch(3x) - osx
mvadd_wch(3x) - osx
wecho_wchar(3x) - osx
Similar Topics in the Unix Linux Community
Split large xml into mutiple files and with header and footer in file
Instructions to Clear Data Cache in Safari, Chrome, Firefox, Opera Browsers (Pictures)
12-Core MacPro (2013) kernel_task over 1200%
My first PERL incarnation... Audio Oscillograph