curs_printw

curs_printw(3X)						      curs_printw(3X)



NAME
       printw, wprintw, mvprintw, mvwprintw, vwprintw, vw_printw - print for-
       matted output in 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  [see  printf(3S)].  In effect, the string that would be output
       by printf is output instead as though waddstr were used on  the	given
       window.

       The  vwprintw  and  wv_printw  routines	are analogous to vprintf [see
       printf(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 <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  the  same	file as <stdarg.h>.  This implementation uses
       <stdarg.h> for both, because that header is included in <curses.h>.

SEE ALSO
       curses(3X), printf(3S), vprintf(3S)



							      curs_printw(3X)