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

           X/Open defines no error conditions.  In  this  implementa-
           tion,  an  error  may  be  returned  if it cannot allocate
           enough memory for the buffer used to format  the  results.
           It will return an error if the window pointer is null.

## 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 im-
           plementation uses <stdarg.h> for both, because that header
           is included in <curses.h>.

## SEE ALSO

           curses(3x), printf(3S), vprintf(3S)

                                                            curs_printw(3x)