HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
a
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 specified by wchstr into the current or specified window starting
at the current or specified cursor position.
These functions do not advance the cursor. The results are unspecified if wchstr contains any special char-
acters.
The functions end successfully on encountering a null cchar_t. The functions also end successfully when
they fill the current line. If a character cannot completely fit at the end of the current line, those columns
are filled 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 defined.
SEE ALSO
<curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
HP-UX Release 11i: December 2000 − 1 − Section 3−−13
___
___