addstr(3) — Subroutines
Digital
NAME
addstr, waddstr, mvaddstr, mvwaddstr − add string to window
SYNOPSIS
#include <curses.h>
int addstr(str)
char ∗str;
int waddstr(win, str)
WINDOW ∗win;
char ∗str;
int mvaddstr(y, x, str)
int y, x;
char ∗str;
int mvwaddstr(win, y, x, str)
WINDOW ∗win;
int y, x;
char ∗str;
DESCRIPTION
The addstr routine writes all the characters of the null-terminated character string str on the default window at the current (y, x) coordinates.
The routine waddstr writes all the characters of the null terminated character string str on the specified window at the current (y, x) coordinates.
The routine mvaddstr writes all the characters of the null terminated character string str on the default window at the specified (y, x) coordinates.
The routine mvwaddstr writes all the characters of the null terminated character string str on the specified window at the specified (y, x) coordinates.
The following information applies to all the routines. All the routines return ERR if writing the string causes illegal scrolling. In this case the routine will write as much as possible of the string on the window.
These routines are functionally equivalent to calling addch or waddch once for each character in the string.
The routines addstr, mvaddstr, and mvwaddstr are macros.
RETURN VALUES
The addstr, waddstr, mvaddstr, and mvwaddstr functions return OK on success and ERR on error.