# 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.

           Functions  with a "mv" prefix first perform a cursor move-
           ment using wmove, and return an error if the  position  is
           outside the window, or 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)