curs_inwstr(3X)                   SDK R4.11                  curs_inwstr(3X)


NAME
       cursinwstr:  inwstr, innwstr, winwstr, winnwstr, mvinwstr,
       mvinnwstr, mvwinwstr, mvwinnwstr - get a string of wchart characters
       from a curses window

SYNOPSIS
       #include <curses.h>

       int inwstr(wchart *str);
       int innwstr(wchart *str, int n);
       int winwstr(WINDOW *win, wchart *str);
       int winnwstr(WINDOW *win, wchart *str, int n);
       int mvinwstr(int y, int x, wchart *str);
       int mvinnwstr(int y, int x, wchart *str, int n);
       int mvwinwstr(WINDOW *win, int y, int x, wchart *str);
       int mvwinnwstr(WINDOW *win, int y, int x, wchart *str, int n);

DESCRIPTION
       These routines return a string of wchart characters in str, starting
       at the current cursor position in the named window and ending at the
       right margin of the window.  Attributes are stripped from the
       characters.  The four functions with n as the last argument return
       the string at most n wchart characters long.

RETURN VALUE
       All routines return the integer ERR upon failure and an integer value
       other than ERR upon successful completion.

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

       Note that all routines except winnwstr may be macros.

SEE ALSO
       curses(3X).


Licensed material--property of copyright holder(s)