ADDCHSTR(3XCURSES)ADDCHSTR(3XCURSES)NAME
addchstr, addchnstr, mvaddchstr, mvaddchnstr, mvwaddchnstr, mvwaddch‐
str, waddchstr, waddchnstr - copy a character string (with renditions)
to a window
SYNOPSIS
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library ... ]
#include <curses.h>
int addchstr(const chtype *chstr);
int addchnstr(const chtype *chstr, int n);
int mvaddchnstr(int y, int x, const chtype *chstr, int n);
int mvaddchstr(int y, int x, const chtype *chstr);
int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int n);
int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);
int waddchstr(WINDOW *win, const chtype *chstr);
int waddchnstr(WINDOW *win, const chtype *chstr, int n);
DESCRIPTION
The addchstr() function copies the chtype character string to the std‐
scr window at the current cursor position. The mvaddchstr() and mvwad‐
dchstr() functions copy the character string to the starting position
indicated by the x (column) and y (row) parameters (the former to the
stdscr window; the latter to window win). The waddchstr() is identi‐
cal to addchstr(), but writes to the window specified by win.
The addchnstr(), waddchnstr(), mvaddchnstr(), and mvwaddchnstr() func‐
tions write n characters to the window, or as many as will fit on the
line. If n is less than 0, the entire string is written, or as much of
it as fits on the line. The former two functions place the string at
the current cursor position; the latter two commands use the position
specified by the x and y parameters.
These functions differ from the addstr(3XCURSES) set of functions in
two important respects. First, these functions do not advance the cur‐
sor after writing the string to the window. Second, the current window
rendition is not combined with the character; only the attributes that
are already part of the chtype character are used.
PARAMETERS
chstr
Is a pointer to the chtype string to be copied to the window.
n
Is the maximum number of characters to be copied from chstr.
If n is less than 0, the entire string is written or as much
of it as fits on the line.
y
Is the y (row) coordinate of the starting position of chstr in
the window.
x
Is the x (column) coordinate of the starting position of chstr
in the window.
win
Is a pointer to the window to which the string is to be
copied.
RETURN VALUES
On success, these functions return OK. Otherwise, they return ERR.
ERRORS
None.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
├────────────────────┼─────────────────┤
│MT-Level │ Unsafe │
└────────────────────┴─────────────────┘
SEE ALSOaddch(3XCURSES), addnstr(3XCURSES), attroff(3XCURSES),
libcurses(3XCURSES), attributes(5), standards(5)
Jun 5, 2002 ADDCHSTR(3XCURSES)
