ncurses 4.1
[ncurses.git] / 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>