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(cchar_t *const wchstr, int n);

int add_wchstr(cchar_t *const wchstr);

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

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

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

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

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

int mvwadd_wchstr(WINDOW *win, int y, int x, cchar_t *const 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 characters. 

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() functions 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. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996