Whole document tree

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 don't  per-
       form  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

       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.

NOTES

       Note that all routines except waddchnstr may be macros.

PORTABILITY

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

SEE ALSO

       curses(3x).