X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_printw.3x.html;h=1a357f31998bee2c869272c266a9e0e316a3b621;hp=95424b3a430e26faa327e027a78346e8bf882a51;hb=29a36e53e1f77a0c3672f2e267d573823d6a9a60;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;ds=inline diff --git a/doc/html/man/curs_printw.3x.html b/doc/html/man/curs_printw.3x.html index 95424b3a..1a357f31 100644 --- a/doc/html/man/curs_printw.3x.html +++ b/doc/html/man/curs_printw.3x.html @@ -1,78 +1,125 @@ + + + + + +curs_printw 3x + + + +

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(char *fmt [, arg] ...);
-       int wprintw(WINDOW *win, char *fmt [, arg] ...);
-       int mvprintw(int y, int x, char *fmt [, arg] ...);
-       int mvwprintw(WINDOW *win, int y, int x,
-             char *fmt [, arg] ...);
-
-       #include <varargs.h>
-       int vwprintw(WINDOW *win, char *fmt, varglist);
-       int vw_printw(WINDOW *win, char *fmt, 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   routine  is  analogous  to  vprintf  [see
-       printf(3S)] and performs a wprintw using a variable  argu-
-       ment  list.  The third argument is a va_list, a pointer to
-       a list of arguments, as defined in <varargs.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.
+

NAME

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

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

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

SEE ALSO

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

DESCRIPTION

+       The  printw,  wprintw, mvprintw and mvwprintw routines are
+       analogous to  printf  [see  printf(3)].   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(3)]  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.
 
+       Functions  with a "mv" prefix first perform a cursor move-
+       ment using wmove, and return an error if the  position  is
+       outside the window, or 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(3), vprintf(3)
 
 
 
+                                                        curs_printw(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +