CURSINSTR(3X-SVR4) RISC/os Reference Manual  CURSINSTR(3X-SVR4)



NAME
     curs_instr: instr, innstr, winstr, winnstr, mvinstr,
          mvinnstr, mvwinstr, mvwinnstr - get a string of charac-
          ters from a curses window

SYNOPSIS
     #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);

DESCRIPTION
     These routines return a string of characters in str, start-
     ing 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 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 winnstr may be macros.

SEE ALSO
     curses(3X).














                        Printed 11/19/92                   Page 1