curs_addwstr(3ocurses)


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

Synopsis

cc [flag . . .] file -locurses [library . . .]

#include <ocurses.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 similar to calling waddwch 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, then the entire string will be added.

Return values

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

References

curses(3ocurses), curs_addwch(3ocurses)

Notices

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

Note that all of these routines except waddwstr and waddnwstr may be macros.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004