xref: /illumos-gate/usr/src/man/man3curses/curs_printw.3curses (revision 21b85b87534ca210ad665ad1393dd55ca004c0c8)
te
Copyright 1989 AT&T
Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
CURS_PRINTW 3CURSES "Dec 31, 1996"
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>.