curs_printw(3X) | Miscellaneous Library Functions | curs_printw(3X) |
int printw(const char *fmt, ...);
int wprintw(WINDOW *win, const char *fmt,
...);
int mvprintw(int y, int x, const char
*fmt, ...);
int mvwprintw(WINDOW *win, int y, int
x , const char *fmt, ...);
int vw_printw(WINDOW *win, const char *fmt,
va_list varglist);
/* obsolete */
int vwprintw(WINDOW *win, const char *fmt,
va_list varglist);
The vwprintw and vw_printw routines are analogous to vprintf [see printf(3)] and perform a wprintw using a variable argument list. The third argument is a va_list, a pointer to a list of arguments, as defined in <stdarg.h>.
X/Open defines no error conditions. In this implementation, an error may be returned if it cannot allocate enough memory for the buffer used to format the results. It will return an error if the window pointer is null.
Functions with a “mv” prefix first perform a cursor movement using wmove, and return an error if the position is outside the window, or if the window pointer is null.
SVr2 documented printw, wprintw tersely as “printf on stdscr” and tersely as “printf on win”, respectively.
SVr3 added mvprintw, and mvwprintw, with a three-line summary saying that they were analogous to printf(3), explaining that the string which would be output from printf(3) would instead be output using waddstr on the given window. SVr3 also added vwprintw, saying that the third parameter is a va_list, defined in <varargs.h>, and referring the reader to the manual pages for varargs and vprintf for detailed descriptions.
SVr4 added no new variations of printw, but provided for using <varargs.h> or <stdarg.h> to define the va_list type.
X/Open Curses added vw_printw to replace vwprintw, stating that its va_list definition requires <stdarg.h>.
OmniOS |