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.