mvprintw(3XC)

NAME

mvprintw, mvwprintw, printw, vw_printw, vwprintw, wprintw − write formatted output to window

SYNOPSIS

#include <curses.h>

int mvprintw(int y, int x, char ∗fmt [,arg...]);

int mvwprintw(WINDOW ∗win, int y, int x, char ∗fmt [,arg...])

int printw(char ∗fmt [,arg...]);

int vwprintw(WINDOW ∗win, char ∗fmt, void ∗arglist);

int vw_printw(WINDOW ∗win, char ∗fmt, void ∗arglist);

int wprintw(WINDOW ∗win, char ∗fmt[,arg...]);

ARGUMENTS

yIs the y (row) coordinate position of the string’s placement in the window.

xIs the x (column) coordinate position of the string’s placement in the window.

fmt [,arg...]
Is a printf() format string where arg is zero or more parameters used to satisfy the printf() string.

winIs a pointer to the window in which the string is to be written.

fmt, arglist
Is a vprintf() format string where arglist is a pointer to a list of parameters. The vwprintw() function requires a variable parameter list as defined in <varargs.h>. The vw_printw() function requires a variable parameter list as defined in <stdarg.h>.

DESCRIPTION

These functions are functionally equivalent to printf(3S). Their effect is similar to using sprintf(3S) to format the string and then using waddstr(3XC) to add that string to a window.

With printw() and wprintw(), the string is written to stdscr and win, respectively. The mvprintw() and mvwprintw() functions position the cursor as specified in stdscr or win, respectively, and then call printw().

The vwprintw() and vw_printw() functions are similar to wprintw() but use a pointer to a variable parameter list as defined by either <varargs.h> or <stdarg.h>. Each application must include the appropriate header.

RETURN VALUES

On success, these functions return OK. Otherwise, they return ERR.

ERRORS

None.

Museum

Related Articles