NAME

curs_addstr, addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr - add a string of characters to a curses window and advance cursor

SYNOPSIS

#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);

MT-LEVEL

Unsafe

DESCRIPTION

All of these routines write all the characters of the null terminated character string str on the given window. It 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.

SEE ALSO

curs_addch(3X), curses(3X)

NOTES

The header <curses.h> automatically includes the headers <stdio.h> and <unctrl.h>.

Note that all routines except waddstr( ) and waddnstr( ) may not be macros.