https://invisible-island.net/ncurses/man/


curs_addstr 3x 2024-03-23 ncurses 6.4 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  with  a  "mv"  prefix  first  perform  cursor movement using
       wmove(3x) and fail if the position is outside the window, or (for "mvw"
       functions) if the WINDOW pointer is null.


NOTES

       All of these functions except waddnstr may be macros.


PORTABILITY

       X/Open Curses, Issue 4 describes these functions.


SEE ALSO

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

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



ncurses 6.4                       2024-03-23                   curs_addstr(3x)