curs_printw(3X) curs_printw(3X) NAME printw, wprintw, mvprintw, mvwprintw, vwprintw, vw_printw - print for- matted output in(1,8) curses windows 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, ...); int vwprintw(WINDOW *win, const char *fmt, va_list varglist); int vw_printw(WINDOW *win, const char *fmt, va_list varglist); DESCRIPTION The printw, wprintw, mvprintw and mvwprintw routines are analogous to printf(1,3,1 builtins) [see printf(1,3,1 builtins)(3S)]. In effect, the string(3,n) that would be output by printf(1,3,1 builtins) is output instead as though waddstr were used on the given win- dow. The vwprintw and wv_printw routines are analogous to vprintf [see printf(1,3,1 builtins)(3S)] and perform a wprintw using a variable argument list. The third argument is a va_list, a pointer to a list of arguments, as defined in(1,8) <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 com- pletion. PORTABILITY The XSI Curses standard, Issue 4 describes these functions. The func- tion vwprintw is marked TO BE WITHDRAWN, and is to be replaced by a function vw_printw using the <stdarg.h> interface. The Single Unix Specification, Version 2 states that vw_printw is preferred to vwprintw since the latter requires including <varargs.h>, which cannot be used in(1,8) the same file(1,n) as <stdarg.h>. This implementation uses <stdarg.h> for both, because that header is included in(1,8) <curses.h>. SEE ALSO curses(3X), printf(1,3,1 builtins)(3S), vprintf(3S) curs_printw(3X)