# curs_printw 3x

    curs_printw(3x)                                   curs_printw(3x)

## NAME

           printw,  wprintw, mvprintw, mvwprintw, vwprintw, vw_printw
           - print formatted 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 var-
           glist);
           int vw_printw(WINDOW *win, const char *fmt,  va_list  var-
           glist);

## 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)

                                                      curs_printw(3x)