add_wch.3x (2010 09)

add_wch(3X) add_wch(3X)

(ENHANCED CURSES)

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 speciﬁed window at the current or speciﬁed 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 speciﬁed by wch is placed at that location with rendition speciﬁed 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

speciﬁed by wch is ignored.

RETURN VALUE

Upon successful completion, these functions return

OK. Otherwise, they return ERR.

ERRORS

No errors are deﬁned.

PAGE 1
add_wch(3X) add_wch(3X) (ENHANCED CURSES) NAME add_wch, mvadd_wch, mvwadd_wch, wadd_wch — add a complex character and rendition to a window SYNOPSIS #include 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); A 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.
PAGE 2
(Notes) A (Notes) aA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010