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