ADDCHSTR(3XCURSES) X/Open Curses Library Functions ADDCHSTR(3XCURSES)
NAME
addchstr, addchnstr, mvaddchstr, mvaddchnstr, mvwaddchnstr,
mvwaddchstr, 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
stdscr window at the current cursor position. The
mvaddchstr() and
mvwaddchstr() 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 identical to
addchstr(), but writes to the window
specified by
win.
The
addchnstr(),
waddchnstr(),
mvaddchnstr(), and
mvwaddchnstr() functions 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
cursor 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
addch(3XCURSES),
addnstr(3XCURSES),
attroff(3XCURSES),
libcurses(3XCURSES),
attributes(7),
standards(7) June 5, 2002 ADDCHSTR(3XCURSES)
