Unix/Linux Go Back    


NetBSD 6.1.5 - man page for addstr (netbsd section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


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 routines

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 cur-
     rently 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 specified 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
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 08:04 PM.