curses_addstr(3) [netbsd man page]

CURSES_ADDSTR(3)					   BSD Library Functions Manual 					  CURSES_ADDSTR(3)

NAME

     curses_addstr, addstr, waddstr, addnstr, waddnstr, mvaddstr, mvwaddstr, mvaddnstr, mvwaddnstr -- curses add character strings to windows rou-
     tines

LIBRARY

     Curses Library (libcurses, -lcurses)

SYNOPSIS

     #include <curses.h>

     int
     addstr(const char *string);

     int
     waddstr(WINDOW *win, const char *string);

     int
     mvaddstr(int y, int x, const char *string);

     int
     mvwaddstr(WINDOW *win, int y, int x, const char *string);

     int
     addnstr(const char *string, int len);

     int
     waddnstr(WINDOW *win, const char *string, int len);

     int
     mvaddnstr(int y, int x, const char *string, int len);

     int
     mvwaddnstr(WINDOW *win, int y, int x, const char *string, int len);

DESCRIPTION

     These functions add character strings to stdscr or to the specified window.

     The addstr() function will add the characters passed in string to stdscr starting at the current cursor position.	Any background attributes
     currently set on stdscr will be applied to the added character.  The waddstr() function does the same as addstr() but adds the string to the
     window specified by win().

     The addnstr() function will add the contents of string to stdscr but will limit the number of characters added to be, at most, len.  If len
     is -1 then addnstr will add the number of characters contained in the null terminated string string.  Any background attributes currently set
     on stdscr will be applied to the added character.	The waddnstr() function does the same as addnstr but adds the string to the window speci-
     fied by win.

     The functions mvaddstr(), mwaddnstr(), mvwaddstr() and mvwaddnstr() are the same as the functions addstr(), waddstr(), waddstr() and
     waddnstr(), respectively, excepting that wmove() is called to move the cursor to the position specified by y, x before the string is added to
     the window.

RETURN VALUES

     Functions returning pointers will return NULL if an error is detected.  The functions that return an int will return one of the following
     values:

     OK   The function completed successfully.
     ERR  An error occurred in the function.

SEE ALSO

     curses_addch(3), curses_addchstr(3), curses_attributes(3), curses_cursor(3), curses_inch(3)

STANDARDS

     The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.

HISTORY

     The Curses package appeared in 4.0BSD.

BSD
								   May 21, 2003 							       BSD

Check Out this Related Man Page

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)

Linux and UNIX Man Pages

curses_addstr(3) [netbsd man page]

Check Out this Related Man Page