NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       These routines copy chstr into the window image  structure
       at  and  after the current cursor position.  The four routines
 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  characters
 that will fit on the line.

       The window cursor is not advanced, and these routines work
       faster than waddnstr.  On the other hand, they don't  perform
  any  kind  of  checking  (such  as  for the newline,
       backspace, or  carriage  return  characters),  they  don't
       advance  the  current  cursor  position, they don't expand
       other control characters to ^-escapes, and  they  truncate
       the  string  if  it  crosses the right margin, rather then
       wrapping it around to the new line.

RETURN VALUES    [Toc]    [Back]

       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 otherwise
 noted in the preceding routine descriptions.

NOTES    [Toc]    [Back]

       Note that all routines except waddchnstr may be macros.

PORTABILITY    [Toc]    [Back]

       All  these  entry  points  are described in the XSI Curses
       standard, Issue 4.

SEE ALSO    [Toc]    [Back]

       curses(3).