*** UNIX MANUAL PAGE BROWSER ***

curs_inwchstr(3) Library Functions Manual curs_inwchstr(3) NAME curs_inwchstr, inwchstr, inwchnstr, winwchstr, winwchnstr, mvinwchstr, mvinwchnstr, mvwinwchstr, mvwinwchnstr - Get a string of wchar_t char- acters (and attributes) from a Curses window LIBRARY Curses Library (libcurses.a, libcurses.so) SYNOPSIS #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); DESCRIPTION These routines return a string of type chtype, holding wchar_t charac- ters, starting at the current or specified cursor position in the cur- rent 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) op- erator to extract the wchar_t character or the attribute alone from any position in chstr (see curs_inwch(3)). NOTES 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. Digital recommends the use of the *in_wchstr and *in_wchnstr functions in new applications (see curs_in_wchstr(3)). RETURN VALUES All routines return the integer ERR upon failure and an integer value other than ERR upon successful completion. RELATED INFORMATION Functions curses(3), curs_in_wchstr, curs_inwch(3) delim off curs_inwchstr(3)