curs_addstr(3ocurses)
curs_addstr: addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr --
add a string of characters to a curses window and advance cursor
Synopsis
cc [flag . . .] file -locurses [library . . .]
#include <ocurses.h>
int addstr(char str);
int addnstr(char str, int n);
int waddstr(WINDOW win, char str);
int waddnstr(WINDOW win, char str, int n);
int mvaddstr(int y, int x, char str);
int mvaddnstr(int y, int x, char str, int n);
int mvwaddstr(WINDOW win, int y, int x, char str);
int mvwaddnstr(WINDOW win, int y, int x, char str, int n);
Description
All of these routines write all the characters of the
null-terminated character string str on the given window.
The effect is similar to calling
waddch
once for each character in the string.
The four routines with n as the last
argument write at most n characters.
If n is negative,
then the entire string will be added.
Return values
All routines return the integer ERR upon
failure and an integer value other than ERR
upon successful completion.
References
curses(3ocurses),
curs_addch(3ocurses)
Notices
The header file ocurses.h automatically includes the header files
stdio.h and unctrl.h.
Note that all of these routines except waddstr
and waddnstr may be macros.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004