curses_addchstr(3)
- NetBSD Manual Pages
CURSES_ADDCHSTR(3) NetBSD Library Functions Manual CURSES_ADDCHSTR(3)
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.
NetBSD 9.1 May 21, 2003 NetBSD 9.1
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.