X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_printw.3x.html;h=cb50d7b7ee445b611ea6f9cecd54e49be8d34176;hp=f6da12390bbe40d859b77eca07d16ad721136f7e;hb=c0f109a299a82a33c16bd7af942a12ce9aefaaf0;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40 diff --git a/doc/html/man/curs_printw.3x.html b/doc/html/man/curs_printw.3x.html index f6da1239..cb50d7b7 100644 --- a/doc/html/man/curs_printw.3x.html +++ b/doc/html/man/curs_printw.3x.html @@ -1,6 +1,7 @@ - + curs_printw 3x - + @@ -57,9 +58,11 @@ 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 varglist); int vw_printw(WINDOW *win, const char *fmt, va_list varglist); + /* obsolete */ + int vwprintw(WINDOW *win, const char *fmt, va_list varglist); +

DESCRIPTION

        The printw, wprintw, mvprintw and mvwprintw routines are  analogous  to
@@ -88,18 +91,54 @@
        the window pointer is null.
 
 
+

HISTORY

+       While printw was implemented in 4BSD, it was unused until 4.2BSD (which
+       used it in games).  That early version of curses was before the ANSI  C
+       standard.   It  did not use <varargs.h>, though that was available.  In
+       1991 (a couple of years after SVr4 was generally available,  and  after
+       the  C  standard  was published), other developers updated the library,
+       using <stdarg.h> internally in 4.4BSD curses.  Even with this  improve-
+       ment, BSD curses did not use function prototypes (or even declare func-
+       tions) in the <curses.h> header until 1992.
+
+       SVr2 documented printw, wprintw  tersely  as  "printf  on  stdscr"  and
+       tersely as "printf on win", respectively.
+
+       SVr3  added  mvprintw,  and mvwprintw, with a three-line summary saying
+       that they were analogous to printf(3), explaining that the string which
+       would be output from printf(3) would instead be output using waddstr on
+       the given window.  SVr3 also added vwprintw, saying that the third  pa-
+       rameter  is a va_list, defined in <varargs.h>, and referring the reader
+       to the manual pages for varargs and vprintf for detailed descriptions.
+
+       SVr4 added  no  new  variations  of  printw,  but  provided  for  using
+       <varargs.h> or <stdarg.h> to define the va_list type.
+
+       X/Open  Curses  added  vw_printw  to replace vwprintw, stating that its
+       va_list definition requires <stdarg.h>.
+
+
 

PORTABILITY

-       The  XSI Curses standard, Issue 4 describes these functions.  The func-
-       tion 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, Version 2 states that vw_printw   is  preferred  to  vw-
-       printw 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>.
+       In this implementation, vw_printw and vwprintw are equivalent, to  sup-
+       port legacy applications.  However, the latter (vwprintw) is obsolete:
+
+       o   The  XSI  Curses  standard, Issue 4 described these functions.  The
+           function vwprintw is marked TO BE WITHDRAWN, and is to be  replaced
+           by a function vw_printw using the <stdarg.h> interface.
+
+       o   The  Single Unix Specification, Version 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>.
+
+       o   X/Open  Curses, Issue 5 (December 2007) marked vwprintw (along with
+           vwscanw and the termcap interface) as withdrawn.
 
 
 

SEE ALSO

-       curses(3x), printf(3), vprintf(3).
+       curses(3x), curs_addstr(3x), curs_scanw(3x), curs_termcap(3x),
+       printf(3), vprintf(3).
 
 
 
@@ -111,6 +150,7 @@
 
  • SYNOPSIS
  • DESCRIPTION
  • RETURN VALUE
  • +
  • HISTORY
  • PORTABILITY
  • SEE ALSO