inchnstr(3X)                                                   inchnstr(3X)

NAME
     inchnstr, inchstr, mvinchnstr, mvinchstr, mvwinchnstr, mvwinchstr,
     winchnstr, winchstr - input an array of single-byte characters and
     renditions from a window

SYNOPSIS
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int inchnstr(chtype *chstr, int n);

     int inchstr(chtype *chstr);

     int mvinchnstr(int y, int x, chtype *chstr, int n);

     int mvinchstr(int y, int x, chtype *chstr);

     int mvwinchnstr(WINDOW *win, int y, int x, chtype *chstr, int n);

     int mvwinchstr(WINDOW *win, int y, int x, chtype *chstr);

     int winchnstr(WINDOW *win, chtype *chstr, int n);

     int winchstr(WINDOW *win, chtype *chstr);

DESCRIPTION
     These functions place characters and renditions from the current or
     specified window into the array pointed to by chstr, starting at the
     current or specified position and ending at the end of the line.

     The inchnstr(), mvinchnstr(), mvwinchnstr() and winchnstr() functions
     store at most n elements from the current or specified window into the
     array pointed to by chstr.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.

NOTES
     Reading a line that overflows the array pointed to by chstr with
     inchstr(), mvinchstr(), mvwinchstr() or winchstr() causes undefined
     results. The use of inchnstr(), mvinchnstr(), mvwinchnstr() or
     winchnstr(), respectively, is recommended.

SEE ALSO
     curses(3X), inch(3X), curses(5).





Page 1                       Reliant UNIX 5.44                Printed 11/98