Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: July 2017
 
 

mvwprintw(3CURSES)

Name

curs_printw, printw, wprintw, mvprintw, mvwprintw, vwprintw - print formatted output in curses windows

Synopsis

cc [ flag ... ] file ... –lcurses [ library ... ]
#include <curses.h>

int printw(char *fmt, /* arg */ ... );
int wprintw(WINDOW *win, char *fmt, /* arg */ ... );
int mvprintw(int y, int x, char *fmt, /* arg */ ... );
int mvwprintw(WINDOW *win, int y, int x, char *fmt, /* arg */... );
#include <varargs.h>

int vwprintw(WINDOW *win, char *fmt, /* varglist */ ... );

Description

The printw(), wprintw(), mvprintw(), and mvwprintw() routines are analogous to printf() (see printf(3C) ). In effect, the string that would be output by printf() is output instead as though waddstr() were used on the given window.

The vwprintw() routine is analogous to vprintf() (see vprintf(3C)) and performs a wprintw() using a variable argument list. The third argument is a va_list, a pointer to a list of arguments, as defined in <varargs.h>.

Return Values

All routines return the integer ERR upon failure and an integer value other than ERR upon successful completion.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
Unsafe

See Also

curses(3CURSES), printf(3C), vprintf(3C), attributes(5)

Notes

The header <curses.h> automatically includes the headers <stdio.h> and <unctrl.h>.