Content-type: text/html
curs_addstr, addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr - Add a string of characters to a Curses window and advance cursor
#include <curses.h>
int addstr(
const char *str
);
int addnstr(
const char *str,
int n
);
int waddstr(
WINDOW *win,
const char *str
);
int waddnstr(
WINDOW *win,
const char *str,
int n
);
int mvaddstr(
int y,
int x,
const char *str
);
int mvaddnstr(
int y,
int x,
const char *str,
int n
);
int mvwaddstr(
WINDOW *win,
int y,
int x,
const char *str
);
int mvwaddnstr(
WINDOW *win,
int y,
int x,
const char *str,
int n
);
Interfaces documented on this reference page conform to industry standards as follows:
addstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr: XPG4-UNIX
Refer to the
standards(5)
reference page for more information
about industry standards and associated tags.
These routines write the characters of the character string str on the given window. The four routines with n as the last argument write at most n characters. For the other routines, the string should be null-terminated.
The effect of these functions is similar to calling
waddch
once for each character in the string. If
n
is negative, all routines add the entire string.
The header file <curses.h> automatically includes the header file <stdio.h>.
Note that all of these routines except
waddnstr
may
be macros.
All routines return the integer
ERR
upon
failure and
OK
upon successful completion.
Functions: curses(3), curs_addch(3)
Others: standards(5)