addnwstr(3curses)

addnwstr -- add a wide-character string to a window and advance the cursor

Synopsis

cc [options] file -lcurses

#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 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(3curses), 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(3curses), mvaddnwstr(3curses), mvwaddnwstr(3curses) and waddnwstr(3curses) 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.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

add_wch(3curses), curses(4)