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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Unsafe Standard See standards(5).

See also

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