Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 win‐
     dow.

     The addstr() function will add the characters passed in string to stdscr
     starting at the current cursor position.  Any background attributes cur‐
     rently 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 ter‐
     minated 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 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

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome