NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_addch(3)

       Others: standards(5)



                                                   curs_addstr(3)