curs_addwstr(3curses)


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 -lcurses [library . . .] 
   

#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 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(3curses), curs_addwch(3curses)

Notices

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

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


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.