CURS_ADDCHSTR(3CURSES) Curses Library Functions CURS_ADDCHSTR(3CURSES)


NAME


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

SYNOPSIS


cc [ flag ... ] file ... -lcurses [ library ... ]
#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


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 works
faster than waddnstr() (see curs_addstr(3CURSES)) because they merely
copy chstr into the window image structure. On the other hand, care must
be taken when using these functions because they do not perform any kind
of checking (such as for the newline character), they do not advance the
current cursor position, and they truncate the string, rather then
wrapping it around to the next line.

RETURN VALUES


All routines return the integer ERR upon failure and an integer value
other than ERR upon successful completion.

ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO


curs_addstr(3CURSES), curses(3CURSES), attributes(7)

NOTES


The header <curses.h> automatically includes the headers <stdio.h> and
<unctrl.h>.


Note that all routines except waddchnstr() and waddchstr() may be macros.


December 31, 1996 CURS_ADDCHSTR(3CURSES)