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)