MVSCANW(3XCURSES) X/Open Curses Library Functions MVSCANW(3XCURSES)

NAME

mvscanw, mvwscanw, scanw, wscanw - 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 <curses.h>

int mvscanw(int y, int x, char *fmt, ...);


int mvwscanw(WINDOW *win, int y, int x, char *fmt, ...);


int scanw(char *fmt, ...);


int wscanw(WINDOW *win, char *fmt, ...);

PARAMETERS

y
Is the y (row) coordinate of the position of the character to
be read.


x
Is the x (column) coordinate of the position of the character
to be read.


fmt
Is a scanf() format string.


win
Is a pointer to the window in which the character is to be
read.

DESCRIPTION

These functions are similar to scanf(3C). Their effect is as though
mvwgetstr(3XCURSES) were called to get a multi-byte character string
from the current or specified window at the current or specified
cursor position, and then sscanf() were used to interpret and convert
that string.

RETURN VALUES

Upon successful completion, these functions return OK. Otherwise,
they return ERR.

ERRORS

No errors are defined.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO

scanf(3C), wcstombs(3C), getnstr(3XCURSES), libcurses(3XCURSES),
printw(3XCURSES), attributes(7), standards(7)

June 5, 2002 MVSCANW(3XCURSES)