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

NAME

6       curs_inwchstr,  inwchstr, inwchnstr, winwchstr, winwchnstr, mvinwchstr,
7       mvinwchnstr, mvwinwchstr, mvwinwchnstr - get a string of wchar_t  char‐
8       acters (and attributes) from a curses window
9

SYNOPSIS

11       cc [ flag ... ] file ... -lcurses [ library .. ]
12       #include <curses.h>
13
14       int inwchstr(chtype *wchstr);
15
16
17       int inwchnstr(chtype *wchstr, int n);
18
19
20       int winwchstr(WINDOW *win, chtype *wchstr);
21
22
23       int winwchnstr(WINDOW *win, chtype *wchstr, int n);
24
25
26       int mvinwchstr(int y, int x, chtype *wchstr);
27
28
29       int mvinwchnstr(int y, int x, chtype *wchstr, int n);
30
31
32       int mvwinwchstr(WINDOW *win, int y, int x, chtype *wchstr);
33
34
35       int mvwinwchnstr(WINDOW *win, int y, int x, chtype *wchstr, int n);
36
37

DESCRIPTION

39       These  routines return a string of type  chtype, holding  wchar_t char‐
40       acters, starting at the current cursor position in the named window and
41       ending at the right margin of the window. The four functions with  n as
42       the last argument, return the string  at  most   n  wchar_t  characters
43       long.  Constants  defined  in  <curses.h> can be used with the  logical
44       AND (&) operator to extract the  wchar_t  character  or  the  attribute
45       alone from any position in the wchstr (see curs_inwch(3CURSES)).
46

RETURN VALUE

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

ATTRIBUTES

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

SEE ALSO

64       curses(3CURSES), curs_inwch(3CURSES), attributes(5)
65

NOTES

67       The header file <curses.h>  automatically  includes  the  header  files
68       <stdio.h>, <unctrl.h> and <widec.h>.
69
70
71       Note that all routines except  winwchnstr() may be macros.
72
73
74       None of these routines can use the color attribute in chtype.
75
76
77
78SunOS 5.11                        31 Dec 1996           curs_inwchstr(3CURSES)