addchstr(3X)                                                   addchstr(3X)

NAME
     addchstr, addchnstr, mvaddchstr, mvaddchnstr, mvwaddchstr,
     mvwaddchnstr, waddchstr, waddchnstr - add string of single-byte char-
     acters and renditions to a window

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

     #include <curses.h>

     int addchstr(const chtype *chstr);

     int addchnstr(const chtype *chstr, int n);

     int mvaddchstr(int y, int x, const chtype *chstr);

     int mvaddchnstr(int y, int x, const chtype *chstr, int n);

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

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

     int waddchstr(WINDOW *win, const chtype *chstr);

     int waddchnstr(WINDOW *win, const chtype *chstr, int n);

DESCRIPTION
     These functions overlay the contents of the current or specified win-
     dow, starting at the current or specified position, with the contents
     of the array pointed to by chstr until a null chtype is encountered in
     the array pointed to by chstr.

     These functions do not change the cursor position. These functions do
     not perform special-character processing. These functions do not per-
     form wrapping.

     The addchnstr(), mvaddchnstr(), mvwaddchnstr() and waddchnstr() func-
     tions copy at most n items, but no more than will fit on the current
     or specified line. If n is -1 then the whole string is copied, to the
     maximum number that fit on the current or specified line.

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

ERRORS
     No errors are defined.







Page 1                       Reliant UNIX 5.44                Printed 11/98

addchstr(3X)                                                   addchstr(3X)

NOTES
     These functions are only guaranteed to operate reliably on character
     sets in which each character fits into a single byte, whose attributes
     can be expressed using only constants with the A prefix.

SEE ALSO
     addch(3X), addwch(3X), addwchstr(3X), curses(3X), curses(5).















































Page 2                       Reliant UNIX 5.44                Printed 11/98