Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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
Committed
MT-Level
Unsafe
Standard

See Also

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