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  win-
       dow.

       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)