NAME
curses_addchstr,
addchstr,
waddchstr,
addchnstr,
waddchnstr,
mvaddchstr,
mvwaddchstr,
mvaddchnstr,
mvwaddchnstr —
curses add character
strings to windows routines
LIBRARY
Curses Library (libcurses, -lcurses)
SYNOPSIS
#include <curses.h>
int
addchstr(
const
chtype *chstr);
int
waddchstr(
WINDOW
*win,
const chtype
*chstr);
int
mvaddchstr(
int
y,
int x,
const chtype *chstr);
int
mvwaddchstr(
WINDOW
*win,
int y,
int x,
const chtype *chstr);
int
addchnstr(
const
chtype *chstr,
int
n);
int
waddchnstr(
WINDOW
*win,
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);
DESCRIPTION
These functions add character strings and attributes to
stdscr
or to the specified window.
The
addchstr() function will add the characters and their
attributes passed in
chstr to
stdscr
starting at the current cursor position. Any
character attributes set in
chstr will be merged with
the background attributes currently set on
stdscr
. The
waddstr() function does the same as
addchstr() but adds the string to the window specified by
win().
The
addchnstr() function will add the contents of
string to
stdscr
but will limit
the number of characters added to be, at most,
n. If
n is -1 then
addchnstr will add
the number of characters contained in the null terminated string
chstr. Any character attributes set in
chstr will be merged with the background attributes
currently set on
stdscr
.
The
waddchnstr() function does the same as
addchnstr but adds the string to the window specified by
win.
The functions
mvaddchstr(),
mwaddchnstr(),
mvwaddchstr() and
mvwaddchnstr() are the
same as the functions
addchstr(),
waddchstr(),
waddchstr() and
waddchnstr(), respectively, except that
wmove() is called to move the cursor to the position
specified by
y,
x before the
string is added to the window.
RETURN VALUES
The functions will return one of the following values:
OK
- The function completed successfully.
ERR
- An error occurred in the function.
SEE ALSO
curses_addch(3),
curses_addstr(3),
curses_attributes(3),
curses_cursor(3),
curses_inch(3)
STANDARDS
The
NetBSD Curses library complies with the X/Open
Curses specification, part of the Single Unix Specification.
HISTORY
These functions first appeared in
NetBSD 2.0.