addnwstr.3x (2010 09)

addnwstr(3X) addnwstr(3X)

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

int addwstr(const wchar_t *wstr);

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

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

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

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

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

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

DESCRIPTION

These functions write the characters of the wide character string wstr on the current or speciﬁed window

at that window’s current or speciﬁed 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 speciﬁed 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 deﬁned.