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)