1curs_addwstr(3CURSES)      Curses Library Functions      curs_addwstr(3CURSES)
2
3
4

NAME

6       curs_addwstr,   addwstr,   addnwstr,  waddwstr,  waddnwstr,  mvaddwstr,
7       mvaddnwstr, mvwaddwstr, mvwaddnwstr - add a string of  wchar_t  charac‐
8       ters to a curses window and advance cursor
9

SYNOPSIS

11       cc  [flag]... file... -lcurses [library]...
12
13
14       #include<curses.h>
15
16       int addwstr(wchar_t *wstr);
17
18
19       int addnwstr(wchar_t *wstr, int n);
20
21
22       int waddwstr(WINDOW *win, wchar_t *wstr);
23
24
25       int waddnwstr(WINDOW *win, wchar_t *wstr, int n);
26
27
28       int mvaddwstr(int y, int x, wchar_t *wstr);
29
30
31       int mvaddnwstr(int y, int x, wchar_t *wstr, int n);
32
33
34       int mvwaddwstr(WINDOW *win, int y, int x , wchar_t *wstr);
35
36
37       int mvwaddnwstr(WINDOW *win, int y, int x, wchar_t *wstr, int n);
38
39

DESCRIPTION

41       All  of  these routines write all the characters of the null-terminated
42       wchar_t character string  wstr on the given window. The effect is simi‐
43       lar to calling waddwch(3CURSES) once for each  wchar_t character in the
44       string. The four routines with n as the last argument write at  most  n
45       wchar_t  characters.  If  n is negative, then the entire string will be
46       added.
47

RETURN VALUE

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

ATTRIBUTES

53       See attributes(5) for descriptions of the following attributes:
54
55
56
57
58       ┌─────────────────────────────┬─────────────────────────────┐
59       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │MT-Level                     │Unsafe                       │
62       └─────────────────────────────┴─────────────────────────────┘
63

SEE ALSO

65       curses(3CURSES), waddwch(3CURSES), attributes(5)
66

NOTES

68       The  header  file   <curses.h>  automatically includes the header files
69       <stdio.h>, <nctrl.h> and <widec.h>.
70
71
72       Note that all of these routines except  waddwstr() and  waddnwstr() may
73       be macros.
74
75
76
77SunOS 5.11                        31 Dec 1996            curs_addwstr(3CURSES)