# curs_addstr 3x 2024-04-20 ncurses 6.5 Library calls

    curs_addstr(3x)                  Library calls                 curs_addstr(3x)

## NAME

           addstr,  addnstr,  waddstr,  waddnstr,  mvaddstr, mvaddnstr, mvwaddstr,
           mvwaddnstr - add a string to a curses window and advance the cursor

## SYNOPSIS

           #include <curses.h>

           int addstr(const char *str);
           int mvaddstr(int y, int x, const char *str);
           int mvwaddstr(WINDOW *win, int y, int x, const char *str);
           int waddstr(WINDOW *win, const char *str);

           int addnstr(const char *str, int n);
           int mvaddnstr(int y, int x, const char *str, int n);
           int mvwaddnstr(WINDOW *win, int y, int x, const char *str, int n);
           int waddnstr(WINDOW *win, const char *str, int n);

## DESCRIPTION

           waddstr writes the characters of the (null-terminated)  string  str  to
           the  window win.  Its process is similar to calling waddch(3x) for each
           char in str.  Control characters are processed as in waddch(3x).

           waddnstr writes at most n  characters,  or  until  a  terminating  null
           character  occurs  in  str.   If  n  is  -1, waddnstr writes the entire
           string.

           ncurses(3x) describes the variants of these functions.

## RETURN VALUE

           These functions return OK on success and ERR on failure.

           X/Open Curses does not specify any error conditions.   ncurses  returns
           an error

           o   if the window pointer is NULL,

           o   if the string pointer is NULL, or

           o   if an internal waddch(3x) call returns an error.

           Functions  prefixed with "mv" first perform cursor movement and fail if
           the position (y, x) is outside the window boundaries.

## NOTES

           All of these functions except waddnstr may be macros.

## PORTABILITY

           X/Open Curses, Issue 4 describes these functions.

## SEE ALSO

           curs_addwstr(3x) describes comparable functions of the ncurses  library
           in its wide-character configuration (ncursesw).

           curses(3x), curs_addch(3x), curs_addchstr(3x)

    ncurses 6.5                       2024-04-20                   curs_addstr(3x)