Curses Library Functions cursscanw(3CURSES)
NAME
cursscanw, scanw, wscanw, mvscanw, mvwscanw, vwscanw - con-
vert formatted input from a curses widow
SYNOPSIS
cc [ flag ... ] file ... -lcurses [ library ... ]
#include
int scanw(char *fmt, /* arg */ ...);
int wscanw(WINDOW *win, char *fmt, /* arg */ ...);
int mvscanw(int y, int x, char *fmt, /* arg */ ...);
int mvwscanw(WINDOW *win, int y, int x, char *fmt, /* arg */...);
int vwscanw(WINDOW *win, char *fmt, valist varglist);
DESCRIPTION
The scanw(), wscanw(), and mvscanw() routines correspond to
scanf() (see scanf(3C)). The effect of these routines is as
though wgetstr() were called on the window, and the result-
ing line used as input for the scan. Fields which do not map
to a variable in the fmt field are lost.
The vwscanw() routine is similar to vwprintw() in that it
performs a wscanw() using a variable argument list. The
third argument is a valist, a pointer to a list of argu-
ments, as defined in .
RETURN VALUES
vwscanw() returns ER on failure and an integer equal to the
number of fields scanned on success.
Applications may interrogate the return value from the
scanw, wscanw(), mvscanw(), and mvwscanw() routines to
determine the number of fields which were mapped in the
call.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 31 Dec 1996 1
Curses Library Functions cursscanw(3CURSES)
ATRIBUTE TYPE ATRIBUTE VALUE
MT-Level Unsafe
SEE ALSO
cursgetstr(3CURSES), cursprintw(3CURSES), curses(3CURSES),
scanf(3C), attributes(5)
NOTES
The header automatically includes the headers
and .
SunOS 5.11 Last change: 31 Dec 1996 2
|