logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

addstr, waddstr, mvaddstr, mvwaddstr, addnstr, waddnstr, mvaddnstr, mvwaddnstr - add a string to a curses

Description

waddstr  writes  the  characters  of the (null-terminated) string str to the window win, as if by calling
       waddch(3NCURSES) for each char in str.  waddnstr is similar, but writes at most n characters.   If  n  is
       -1, waddnstr writes the entire string.  ncurses(3NCURSES) describes the variants of these functions.

History

       4BSD (1980) introduced waddstr along with its variants, the latter defined as macros.

       SVr3.1 (1987) added waddnstr (and its variants) redefining waddstr as a macro wrapping it.

Name

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

Notes

       All of these functions except waddnstr may be implemented as macros.

Portability

       X/Open Curses Issue 4 describes these functions.  It specifies no error conditions for them.

       SVr4 describes a successful return value only as “an integer value other than ERR”.

Return Value

       These functions return OK on success and ERR on failure.

       In ncurses, they return ERR if

       •   win is NULL,

       •   str is NULL, or

       •   an internal waddch(3NCURSES) call returns ERR.

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

See Also

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

       ncurses(3NCURSES), addch(3NCURSES), addchstr(3NCURSES)

ncurses 6.5                                        2025-02-01                                   addstr(3NCURSES)

Synopsis

#include<curses.h>intaddstr(constchar*str);intwaddstr(WINDOW*win,constchar*str);intmvaddstr(inty,intx,constchar*str);intmvwaddstr(WINDOW*win,inty,intx,constchar*str);intaddnstr(constchar*str,intn);intwaddnstr(WINDOW*win,constchar*str,intn);intmvaddnstr(inty,intx,constchar*str,intn);intmvwaddnstr(WINDOW*win,inty,intx,constchar*str,intn);

See Also