ENHANCED CURSES

NAME

addnwstr, addwstr, mvaddnwstr, mvaddwstr, mvwaddnwstr, mvwaddwstr, waddnwstr, waddwstr — add a wide-character string to a window and advance the cursor

SYNOPSIS

#include <curses.h>

int addnwstr(wchar_t *const wstr, int n);

int addwstr(wchar_t *const wstr);

int mvaddnwstr(int y, int x, wchar_t *const wstr, int n);

int mvaddwstr(int y, int x, wchar_t *const wstr);

int mvwaddnwstr(WINDOW *win, int y, int x, wchar_t *const wstr, int n);

int mvwaddwstr(WINDOW *win, int y, int x, wchar_t *const wstr);

int waddnwstr(WINDOW *win, wchar_t *const wstr, int n);

int waddwstr(WINDOW *win, wchar_t *const wstr);

DESCRIPTION

These functions write the characters of the wide character string wstr on the current or specified window at that window’s current or specified cursor position. 

These functions advance the cursor position.  These functions perform special character processing.  These functions perform wrapping. 

The effect is similar to building a cchar_t from the wchar_t and the background rendition and calling wadd_wch() once for each wchar_t character in the string.  The cursor movement specified by the mv functions occurs only once at the start of the operation. 

The addnwstr(), mvaddnwstr(), mvwaddnwstr() and waddnwstr() functions write at most n wide characters.  If n is −1, then the entire string will be added. 

RETURN VALUE

Upon successful completion, these functions return OK.  Otherwise, they return ERR. 

ERRORS

No errors are defined. 

SEE ALSO

add_wch(), <curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 4. 

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