curs_addstr(3curses)


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 -lcurses [library . . .] 
   

#include <curses.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(3curses), curs_addch(3curses)

Notices

The header file curses.h automatically includes the header files stdio.h and unctrl.h.

Note that all of these routines except waddstr and waddnstr may be macros.


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.