The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group


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


#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);


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.


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


No errors are defined.


add_wch(), <curses.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]