curs_printw()

NAME

printw(), wprintw(), mvprintw(), mvwprintw(), vwprintw() - print formatted output in curses windows

SYNOPSIS

#include <curses.h>

int printw(char *fmt [, arg] ...); int wprintw(WINDOW *win, char *fmt [, arg] ...); int mvprintw(int y, int x, char *fmt [, arg] ...); int mvwprintw(WINDOW *win, int y, int x, char *fmt [, arg] ...);
#include <stdarg.h> int vwprintw(WINDOW *win, char *fmt, varglist); int vw_printw(WINDOW *win, char *fmt, varglist);

DESCRIPTION

The printw(3), wprintw(3), mvprintw(3) and mvwprintw(3) routines are analogous to printf(3). In effect, the string that would be output by printf(3) is output instead as though waddstr(3) were used on the given window.

The vwprintw(3) routine is analogous to vprintf(3) and performs a wprintw(3) using a variable argument list. The third argument is a va_list, a pointer to a list of arguments, as defined in <stdarg.h>. The vw_printw(3) routine is a #define for vwprintw(3). vw_printw(3) is planned for the XSI Curses standard. Traditionally, vwprintw(3) made use of <varargs.h> and vw_printw(3) made use of <stdarg.h>, but both of the routines in this package use <stdarg.h>.

RETURN VALUE

Routines that return an integer return ERR upon failure and OK (SVr4 only specifies an integer value other than ERR) upon successful completion.

SEE ALSO

curses(3)

printf(3)

vprintf(3)