curs_addchstr(3X)					     curs_addchstr(3X)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <curses.h>

     int addchstr(chtype *chstr);

     int addchnstr(chtype *chstr, int n);
     int waddchstr(WINDOW *win,	chtype *chstr);

     int waddchnstr(WINDOW *win, chtype	*chstr,	int n);
     int mvaddchstr(int	y, int x, chtype *chstr);

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

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

DESCRIPTION    [Toc]    [Back]

     All of these routines copy	chstr directly into the	window image structure
     starting at 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
     that fit on the line.

     The position of the window	cursor is not advanced.	 These routines	work
     faster than waddnstr because they merely copy chstr into the window image
     structure.	 On the	other hand, care must be taken when using these
     functions because they don't perform any kind of checking (such as	for
     the newline character), they don't	advance	the current cursor position,
     and they truncate the string, rather then wrapping	it around to the new
     line.

RETURN VALUE    [Toc]    [Back]

     All routines return the integer ERR upon failure and an integer value
     other than	ERR upon successful completion,	unless otherwise noted in the
     preceding routine descriptions.

NOTES    [Toc]    [Back]

     The header	file curses.h automatically includes the header	files stdio.h
     and unctrl.h.

     Note that all routines except waddchnstr may be macros.

SEE ALSO    [Toc]    [Back]

     curses(3X)


									PPPPaaaaggggeeee 1111