osf1 man page for addstr

curs_addstr(3)						     Library Functions Manual						    curs_addstr(3)

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(
	       const char *str ); int addnstr(
	       const char *str,
	       int n ); int waddstr(
	       WINDOW *win,
	       const char *str ); int waddnstr(
	       WINDOW *win,
	       const char *str,
	       int n ); int mvaddstr(
	       int y,
	       int x,
	       const char *str ); int mvaddnstr(
	       int y,
	       int x,
	       const char *str,
	       int n ); int mvwaddstr(
	       WINDOW *win,
	       int y,
	       int x,
	       const char *str ); int mvwaddnstr(
	       WINDOW *win,
	       int y,
	       int x,
	       const char *str,
	       int n );

LIBRARY
       Curses Library (libcurses)

STANDARDS
       Interfaces documented on this reference page conform to industry standards as follows:

       addstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr: XCURSES4.2

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

DESCRIPTION
       These routines write the characters of the character string str on the given window. The four routines with n as the last argument write at
       most n characters. For the other routines, the string should be null-terminated.

       The  effect  of	these functions is similar to calling waddch once for each character in the string. If n is negative, all routines add the
       entire string.

NOTES
       The header file <curses.h> automatically includes the header file <stdio.h>.

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

RETURN VALUES
       All routines return the integer ERR upon failure and OK upon successful completion.

SEE ALSO
       Functions: curses(3), curs_addch(3)

       Others: standards(5)

																    curs_addstr(3)