addchnstr.3x (2010 09)

addchnstr(3X) addchnstr(3X)

(ENHANCED CURSES)

NAME

addchnstr, mvaddchnstr, mvwaddchnstr, waddchnstr — add length limited string of single-byte charac-

ters and renditions to a window

SYNOPSIS

#include <curses.h>

int addchnstr(const chtype *chstr, int n);

int mvaddchnstr(int y, int x, const chtype *chstr, int n);

int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr,

int n);

int waddchnstr(WINDOW *win, const chtype *chstr, int n);

DESCRIPTION

These functions overlay the contents of the current or speciﬁed window, starting at the current or

speciﬁed position, with the contents of the array pointed to by chstr until a null chtype is encountered in

the array pointed to by chstr .

These functions do not change the cursor position. These functions do not perform special-character pro-

cessing. These functions do not perform wrapping.

These functions copy at most n items, but no more than will ﬁt on the line. If n is −1 then the whole

string is copied, to the maximum number that ﬁt on the line.

RETURN VALUE

Upon successful completion, these functions return

OK. Otherwise, they return ERR.

ERRORS

No errors are deﬁned.

APPLICATION USAGE

These functions are only guaranteed to operate reliably on character sets in which each character ﬁts into

a single byte, whose attributes can be expressed using only constants with the A_ preﬁx.