Content-type: text/html
curs_inwchstr, inwchstr, inwchnstr, winwchstr, winwchnstr, mvinwchstr, mvinwchnstr, mvwinwchstr, mvwinwchnstr - Get a string of wchar_t characters (and attributes) from a Curses window
#include <curses.h>
int inwchstr(
chtype *wchstr
);
int inwchnstr(
chtype *wchstr,
int n
);
int winwchstr(
WINDOW *win,
chtype *wchstr
);
int winwchnstr(
WINDOW *win,
chtype *wchstr,
int n
);
int mvinwchstr(
int y,
int x,
chtype *wchstr
);
int mvinwchnstr(
int y,
int x,
chtype *wchstr,
int n
);
int mvwinwchstr(
WINDOW *win,
int y,
int x,
chtype *wchstr
);
int mvwinwchnstr(
WINDOW *win,
int y,
int x,
chtype *wchstr,
int n
);
These routines return a string of type chtype, holding wchar_t characters, starting at the current or specified cursor position in the current or specified window and ending at the right margin of the window.
The four functions with n as the last argument, return the string at most n wchar_t characters long.
Constants defined in
<curses.h>
can be used with the
&
(logical AND) operator to extract
the
wchar_t
character or the attribute alone from any position
in
chstr
(see
curs_inwch(3)).
The header file <curses.h> automatically includes the header file <stdio.h>.
Note that all routines except winwchnstr may be macros.
The routines described on this reference page are among the MNLS Curses
functions that are not included in the X/Open Curses CAE specification. MNLS
routines are supported only for backward compatibility reasons. Compaq
recommends the use of the
*in_wchstr
and
*in_wchnstr
functions in new applications (see
curs_in_wchstr(3)).
All routines return the integer
ERR
upon
failure and an integer value other than
ERR
upon
successful completion.
Functions: curses(3), curs_in_wchstr, curs_inwch(3)