curs_addwstr(S)

curs_addwstr: addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr, mvaddnwstr, mvwaddwstr, mvwaddnwstr -- add a string of wchar_t characters to a curses window and advance cursor

Syntax

cc ... -lcurses

#include <curses.h>

int addwstr(wchar_t *wstr);
int addnwstr(wchar_t *wstr, int n);
int waddwstr(WINDOW *win, wchar_t *wstr);
int waddnwstr(WINDOW *win, wchar_t *wstr, int n);
int mvaddwstr(int y, int x, wchar_t *wstr);
int mvaddnwstr(int y, int x, wchar_t *wstr, int n);
int mvwaddwstr(WINDOW *win, int y, int x, wchar_t *wstr);
int mvwaddnwstr(WINDOW *win, int y, int x, wchar_t *wstr, int n);

Description

All of these routines write all the characters of the null-terminated wchar_t character string str on the given window. The effect is like calling waddwch(S) once for each wchar_t character in the string. The four routines with n as the last argument write at most n wchar_t characters. If n is negative, the entire string is added.

Return values

All routines return the integer ERR on failure and an integer value other than ERR on successful completion.

Warning

The header file curses.h automatically includes the header files stdio.h and unctrl.h.

All of these routines except waddwstr(S) and waddnwstr(S) can be macros.

Files

/usr/lib/libcurses.a: the library

Standards conformance

addwstr(S), addnwstr(S), waddwstr(S), waddnwstr(S), mvaddwstr(S), mvaddnwstr(S), mvwaddwstr(S), and mvwaddnwstr(S) are not part of any currently supported standard; they are extensions of AT&T System V developed by The Santa Cruz Operation, Inc. and maintained by The SCO Group.