NAME
curses_print
,
printw
, wprintw
,
mvprintw
, mvwprintw
,
unctrl
—
curses print formatted strings on
windows routines
LIBRARY
library “libcurses”
SYNOPSIS
#include
<curses.h>
int
printw
(const
char *fmt,
...);
int
wprintw
(WINDOW
*win, const char
*fmt, ...);
int
mvprintw
(int
y, int x,
const char *fmt,
...);
int
mvwprintw
(WINDOW
*win, int y,
int x,
const char *fmt,
...);
char *
unctrl
(chtype
ch);
DESCRIPTION
These functions print formatted strings onstdscr
or on
the specified window.
The
printw
()
function formats and prints its arguments on stdscr
.
The behavior is deliberately similar to that of
printf(3), but, notably, the return value differs.
The
wprintw
()
function is the same as the printw
() function,
excepting that the resulting output is printed on the window specified by
win.
The
mvprintw
()
and
mvwprintw
()
functions are the same as the printw
() and
wprintw
() functions, respectively, excepting that
wmove
()
is called to move the cursor to the position specified by
y, x before the output is
printed on the window.
The
unctrl
()
function returns a printable string representation of the character
ch. If ch is a control character
then it will be converted to the form ^Y.
RETURN VALUES
Functions returning pointers will return
NULL
if an error is detected. The functions that
return an int will return one of the following values:
OK
- The function completed successfully.
ERR
- An error occurred in the function.
SEE ALSO
STANDARDS
The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.
HISTORY
The Curses package appeared in 4.0BSD.