NAME
add_wch, mvadd_wch, mvwadd_wch, wadd_wch — add a complex character and rendition to a window
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);
DESCRIPTION
These functions add information to the current or specified window at the
current or specified position, and then advance the cursor. These
functions perform wrapping. These functions perform special-character
processing.
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; then the cursor 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.
RETURN VALUE
Upon successful completion, these functions return
OK.
Otherwise, they return
ERR.
ERRORS
No errors are defined.
SEE ALSO
Rendition of Characters Placed into a Window
in curses_intro(3X),
addch(3X),
<curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
