VW_SCANW(3XCURSES) X/Open Curses Library Functions VW_SCANW(3XCURSES)
vw_scanw - convert formatted input from a window
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <stdarg.h>
#include <curses.h>
int vw_scanw(WINDOW *win, char *fmt, va_list varglist);
fmt
Is a scanf() format string.
varglist
Is a pointer to a list of parameters.
win
Is a pointer to the window in which the character is to
be read.
The vw_scanw() function achieves the same effect as wscanw(3XCURSES)
using a variable argument list. The third argument is a va_list, as
defined in <stdarg.h>.
Upon successful completion, vw_scanw() returns OK. Otherwise, it
returns ERR.
No errors are defined.
The vw_scanw() function is preferred over vwscanw(3XCURSES). The use
of the vwscanw() and vw_scanw() in the same file will not work, due
to the requirements to include <varargs.h> and <stdarg.h>, which both
contain definitions of va_list.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
scanf(3C), libcurses(3XCURSES), mvscanw(3XCURSES), attributes(7),
standards(7)
June 5, 2002 VW_SCANW(3XCURSES)
NAME
vw_scanw - convert formatted input from a window
SYNOPSIS
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <stdarg.h>
#include <curses.h>
int vw_scanw(WINDOW *win, char *fmt, va_list varglist);
PARAMETERS
fmt
Is a scanf() format string.
varglist
Is a pointer to a list of parameters.
win
Is a pointer to the window in which the character is to
be read.
DESCRIPTION
The vw_scanw() function achieves the same effect as wscanw(3XCURSES)
using a variable argument list. The third argument is a va_list, as
defined in <stdarg.h>.
RETURN VALUES
Upon successful completion, vw_scanw() returns OK. Otherwise, it
returns ERR.
ERRORS
No errors are defined.
USAGE
The vw_scanw() function is preferred over vwscanw(3XCURSES). The use
of the vwscanw() and vw_scanw() in the same file will not work, due
to the requirements to include <varargs.h> and <stdarg.h>, which both
contain definitions of va_list.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
scanf(3C), libcurses(3XCURSES), mvscanw(3XCURSES), attributes(7),
standards(7)
June 5, 2002 VW_SCANW(3XCURSES)