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)