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
10 <STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
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> ...);
18 <STRONG>#include</STRONG> <STRONG><varargs.h></STRONG>
19 <STRONG>int</STRONG> <STRONG>vwprintw(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>char</STRONG> <STRONG>*fmt,</STRONG> <STRONG>varglist);</STRONG>
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.
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><varargs.h></STRONG>.
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.
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><stdarg.h></STRONG> interface.
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>