[w]printw

Perform a printf in the specified window, starting at the current position of the cursor. The printw function acts on the stdscr window.

Format

#include  <curses.h>

printw  (char *format_spec, . . . );

int wprintw  (WINDOW *win, char
             *format_spec, . . . );

Arguments

win
A pointer to the window.
format_spec
A pointer to the format specification string.
. . .
Optional expressions whose resultant types correspond to conversion specifications given in the format specification.

If no conversion specifications are given, you may omit the output sources. Otherwise, the function call must have exactly as many output sources as there are conversion specifications, and the conversion specifications must match the types of the output sources.

Conversion specifications are matched to output sources in left-to- right order. Excess output pointers, if any, are ignored.

Description

The formatting specification (format_spec) and the other arguments are identical to those used with the printf function.

The printw and wprintw functions format and then print the resultant string to the window using the addstr function. For more information, see the printf and scrollok functions in this section. See Chapter 2 for information on format specifiers.

Return Values
OK  Indicates success. 
ERR  Indicates that the function makes the window scroll illegally. 


Previous Page | Next Page | Table of Contents | Index