waddnstr3ncurses

Usage

Overview

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.

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.

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”.