curs_addchstr 3x

curs_addchstr(3x)                                     curs_addchstr(3x)

NAME

       addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr,
       mvaddchnstr, mvwaddchstr, mvwaddchnstr - add a string of
       characters (and attributes) to a curses window

SYNOPSIS

       #include <curses.h>

       int addchstr(const chtype *chstr);
       int addchnstr(const chtype *chstr, int n);
       int waddchstr(WINDOW *win, const chtype *chstr);
       int waddchnstr(WINDOW *win, 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);

DESCRIPTION

       These routines copy chstr into the window image  structure
       at  and  after the current cursor position.  The four rou-
       tines with n as the last argument copy at most n elements,
       but  no  more than will fit on the line.  If n=-1 then the
       whole string is copied, to the maximum number  of  charac-
       ters that will fit on the line.

       The window cursor is not advanced, and these routines work
       faster than waddnstr.  On the other hand, they do not per-
       form  any  kind  of  checking  (such  as  for the newline,
       backspace, or carriage return characters), they do not ad-
       vance the current cursor position, they do not expand oth-
       er control characters to ^-escapes, and they truncate  the
       string  if  it crosses the right margin, rather than wrap-
       ping it around to the new line.

RETURN VALUES

       All routines return the integer ERR upon failure and OK on
       success  (the  SVr4 manuals specify only "an integer value
       other than ERR") upon successful completion, unless other-
       wise noted in the preceding routine descriptions.

       X/Open  does not define any error conditions.  This imple-
       mentation returns an error if the window pointer is  null.

NOTES

       Note that all routines except waddchnstr may be macros.

PORTABILITY

       These  entry  points are described in the XSI Curses stan-
       dard, Issue 4.

SEE ALSO

       curses(3x).

       Comparable functions in the wide-character (ncursesw)  li-
       brary are described in curs_add_wchstr(3x).



                                                      curs_addchstr(3x)