# curs_printw 3x

## NAME

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

## SYNOPSIS

           #include <curses.h>

           int printw(char *fmt, ...);
           int wprintw(WINDOW *win, char *fmt, ...);
           int mvprintw(int y, int x, char *fmt, ...);
           int mvwprintw(WINDOW *win, int y, int x, char *fmt, ...);
           int vwprintw(WINDOW *win, char *fmt, va_list varglist);
           int vw_printw(WINDOW *win, 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 completion.

## PORTABILITY

           The  XSI  Curses  standard,  Issue 4 describes these func-
           tions.  The function 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, Ver-
           sion  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)