HP-UX Reference (11i v1 05/09) - 3 Library Functions A-M (vol 6)

add_wchnstr(3X) add_wchnstr(3X)

(ENHANCED CURSES)

NAME

add_wchnstr, add_wchstr, mvadd_wchnstr, mvadd_wchstr, mvwadd_wchnstr, mvwadd_wchstr,

wadd_wchnstr, wadd_wchstr — add an array of complex characters and renditions to a window

SYNOPSIS

#include <curses.h>

int add_wchnstr(const cchar_t *wchstr, int n);

int add_wchstr(const cchar_t *wchstr);

int wadd_wchnstr(WINDOW *win, const cchar_t *wchstr, int n);

int wadd_wchstr(WINDOW *win, const cchar_t *wchstr);

int mvadd_wchnstr(int y, int x, const cchar_t *wchstr, int n);

int mvadd_wchstr(int y, int x, const cchar_t *wchstr);

int mvwadd_wchnstr(WINDOW *win, int y, int x, const cchar_t *wchstr,

int n);

int mvwadd_wchstr(WINDOW *win, int y, int x, const cchar_t *wchstr);

DESCRIPTION

These functions write the array of cchar_t speciﬁed by wchstr into the current or speciﬁed window starting

at the current or speciﬁed cursor position.

These functions do not advance the cursor. The results are unspeciﬁed if wchstr contains any special char-

acters.

The functions end successfully on encountering a null cchar_t. The functions also end successfully when

they ﬁll the current line. If a character cannot completely ﬁt at the end of the current line, those columns

are ﬁlled with the background character and rendition.

The

add_wchnstr(), mvadd_wchnstr()

, mvwadd_wchnstr() and wadd_wchnstr()

func-

tions end successfully after writing n cchar_ts (or the entire array of cchar_ts, if n is −1).

RETURN VALUE

Upon successful completion, these functions return

OK. Otherwise, they return ERR.

ERRORS

No errors are deﬁned.