Ada95/html/curs_printw.3x.html

   1 <HTML>
   2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
   3 <PRE>
   4        <STRONG>printw</STRONG>,  <STRONG>wprintw</STRONG>,  <STRONG>mvprintw</STRONG>,  <STRONG>mvwprintw</STRONG>,  <STRONG>vwprintw</STRONG> - print
   5        formatted output in <STRONG>curses</STRONG> windows
   6
   7
   8 </PRE>
   9 <H2>SYNOPSIS</H2><PRE>
  10        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
  11
  12        <STRONG>int</STRONG> <STRONG>printw(char</STRONG> <STRONG>*fmt</STRONG> [<STRONG>,</STRONG> <STRONG>arg</STRONG>] <STRONG>...);</STRONG>
  13        <STRONG>int</STRONG> <STRONG>wprintw(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>char</STRONG> <STRONG>*fmt</STRONG> [<STRONG>,</STRONG> <STRONG>arg</STRONG>] <STRONG>...);</STRONG>
  14        <STRONG>int</STRONG> <STRONG>mvprintw(int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>char</STRONG> <STRONG>*fmt</STRONG> [<STRONG>,</STRONG> <STRONG>arg</STRONG>] <STRONG>...);</STRONG>
  15        <STRONG>int</STRONG> <STRONG>mvwprintw(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG>
  16              <STRONG>char</STRONG> <STRONG>*fmt</STRONG> [<STRONG>,</STRONG> <STRONG>arg]</STRONG> ...);
  17
  18        <STRONG>#include</STRONG> <STRONG>&lt;varargs.h&gt;</STRONG>
  19        <STRONG>int</STRONG> <STRONG>vwprintw(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>char</STRONG> <STRONG>*fmt,</STRONG> <STRONG>varglist);</STRONG>
  20
  21
  22 </PRE>
  23 <H2>DESCRIPTION</H2><PRE>
  24        The <STRONG>printw</STRONG>, <STRONG>wprintw</STRONG>, <STRONG>mvprintw</STRONG> and <STRONG>mvwprintw</STRONG>  routines  are
  25        analogous  to  <STRONG>printf</STRONG>  [see  <STRONG><A HREF="printf.3s.html">printf(3S)</A></STRONG>].   In effect, the
  26        string that would be output by <STRONG>printf</STRONG> is output instead as
  27        though <STRONG>waddstr</STRONG> were used on the given window.
  28
  29        The   <STRONG>vwprintw</STRONG>   routine  is  analogous  to  <STRONG>vprintf</STRONG>  [see
  30        <STRONG><A HREF="printf.3s.html">printf(3S)</A></STRONG>] and performs a <STRONG>wprintw</STRONG> using a variable  argu-
  31        ment  list.  The third argument is a <STRONG>va_list</STRONG>, a pointer to
  32        a list of arguments, as defined in <STRONG>&lt;varargs.h&gt;</STRONG>.
  33
  34
  35 </PRE>
  36 <H2>RETURN VALUE</H2><PRE>
  37        Routines that return an integer return  <STRONG>ERR</STRONG>  upon  failure
  38        and  <STRONG>OK</STRONG>  (SVr4 only specifies "an integer value other than
  39        <STRONG>ERR</STRONG>") upon successful completion.
  40
  41
  42 </PRE>
  43 <H2>PORTABILITY</H2><PRE>
  44        The XSI Curses standard, Issue  4  describes  these  func-
  45        tions.   The  function <STRONG>vwprintw</STRONG> is marked TO BE WITHDRAWN,
  46        and is to be replaced by a function  <STRONG>vw_printw</STRONG>  using  the
  47        <STRONG>&lt;stdarg.h&gt;</STRONG> interface.
  48
  49
  50 </PRE>
  51 <H2>SEE ALSO</H2><PRE>
  52        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="printf.3s.html">printf(3S)</A></STRONG>, <STRONG>vprintf(3S)</STRONG>
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66 </PRE>
  67 </BODY>
  68 </HTML>