curs_inchstr(3curses)                          curs_inchstr(3curses)


       NAME
             curs_inchstr: inchstr, inchnstr, winchstr, winchnstr,
             mvinchstr, mvinchnstr, mvwinchstr, mvwinchnstr - get a string
             of characters (and attributes) from a curses window

       SYNOPSIS
             cc [flag . . .] file -lcurses [library . . .]
             #include <curses.h>
             int inchstr(chtype *chstr);
             int inchnstr(chtype *chstr, int n);
             int winchstr(WINDOW *win, chtype *chstr);
             int winchnstr(WINDOW *win, chtype *chstr, int n);
             int mvinchstr(int y, int x, chtype *chstr);
             int mvinchnstr(int y, int x, chtype *chstr, int n);
             int mvwinchstr(WINDOW *win, int y, int x, chtype *chstr);
             int mvwinchnstr(WINDOW *win, int y, int x, chtype *chstr, int n);

       DESCRIPTION
             These routines return a string of type chtype, starting at the
             current cursor position in the named 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 characters long.
             Constants defined in curses.h can be used with the & (logical
             AND) operator to extract the character or the attribute alone
             from any position in the chstr [see curs_inch(3curses)].

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

       REFERENCES
             curses(3curses), curs_inch(3curses)

       NOTICES
             The header file curses.h automatically includes the header
             files stdio.h and unctrl.h.

             Note that all routines except winchnstr may be macros.










                           Copyright 1994 Novell, Inc.               Page 1