curs_instr(3x)                                           curs_instr(3x)
       instr,  innstr, winstr, winnstr, mvinstr, mvinnstr, mvwin-
       str, mvwinnstr - get a string of characters from a  curses
       window
       #include <curses.h>
       int instr(char *str);
       int innstr(char *str, int n);
       int winstr(WINDOW *win, char *str);
       int winnstr(WINDOW *win, char *str, int n);
       int mvinstr(int y, int x, char *str);
       int mvinnstr(int y, int x, char *str, int n);
       int mvwinstr(WINDOW *win, int y, int x, char *str);
       int  mvwinnstr(WINDOW  *win,  int y, int x, char *str, int
       n);
       These routines return  a  string  of  characters  in  str,
       extracted  starting  at the current cursor position in the
       named window.  Attributes are stripped  from  the  charac-
       ters.   The  four  functions  with  n as the last argument
       return a leading  substring  at  most  n  characters  long
       (exclusive of the trailing NUL).
       All  of the functions return ERR upon failure, or the num-
       ber of characters actually read into the string.
       X/Open defines no error conditions.  In  this  implementa-
       tion, if the window parameter is null or the str parameter
       is null, a zero is returned.
       Functions with a "mv" prefix first perform a cursor  move-
       ment  using  wmove, and return an error if the position is
       outside the window, or if the window pointer is null.
       Note that all routines except winnstr may be macros.
       SVr4 does not document whether a length limit includes  or
       excludes the trailing NUL.
       The  ncurses library extends the XSI description by allow-
       ing a negative value for n.  In this case,  the  functions
       return the string ending at the right margin.
       curses(3x).
                                                         curs_instr(3x)