HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

addchstr(3X) addchstr(3X)

(CURSES)

NAME

addchstr, mvaddchstr, mvwaddchstr, waddchstr — add string of single-byte characters and renditions to a

window

SYNOPSIS

#include <curses.h>

int addchstr(const chtype *chstr);

int mvaddchstr(int y, int x, const chtype *chstr);

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

int waddchstr(WINDOW *win, const chtype *chstr);

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.

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.