Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

wscanw(3) [netbsd man page]

CURSES_SCANW(3) 					   BSD Library Functions Manual 					   CURSES_SCANW(3)

curses_scanw, scanw, wscanw, mvscanw, mvwscanw -- curses read formatted data from screen routines LIBRARY
Curses Library (libcurses, -lcurses) SYNOPSIS
#include <curses.h> int scanw(const char *fmt, ...); int wscanw(WINDOW *win, const char *fmt, ...); int mvscanw(int y, int x, const char *fmt, ...); int mvwscanw(WINDOW *win, int y, int x, const char *fmt, ...); DESCRIPTION
These functions read formatted data from stdscr or from the specified window. The scanw() function is the same as the scanf() function, excepting that the input data stream is read from the current cursor position on stdscr, The wscanw() function is the same as the scanw() function, excepting that the data stream is read from the window specified by win. The mvscanw() and mvwscanw() functions are the same as the scanw() and mvscanw() functions, respectively, excepting that wmove() is called to move the cursor to the position specified by y, x before the data is read from the window. RETURN VALUES
Functions returning pointers will return NULL if an error is detected. The functions that return an int will return one of the following values: OK The function completed successfully. ERR An error occurred in the function. SEE ALSO
curses_cursor(3), curses_print(3), scanf(3) STANDARDS
The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification. HISTORY
The Curses package appeared in 4.0BSD. BSD
August 12, 2002 BSD

Check Out this Related Man Page

curs_scanw(3X)															    curs_scanw(3X)

scanw, wscanw, mvscanw, mvwscanw, vwscanw, vw_scanw - convert formatted input from a curses window SYNOPSIS
#include <curses.h> 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 vw_scanw(WINDOW *win, char *fmt, va_list varglist); int vwscanw(WINDOW *win, char *fmt, va_list varglist); DESCRIPTION
The scanw, wscanw and mvscanw routines are analogous to scanf [see scanf(3S)]. The effect of these routines is as though wgetstr were called on the window, and the resulting line used as input for sscanf(3). 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 va_list, a pointer to a list of arguments, as defined in <varargs.h>. RETURN VALUE
vwscanw returns ERR on failure and an integer equal to the number of fields scanned on success. Applications may use the return value from the scanw, wscanw, mvscanw and mvwscanw routines to determine the number of fields which were mapped in the call. PORTABILITY
The XSI Curses standard, Issue 4 describes these functions. The function vwscanw is marked TO BE WITHDRAWN, and is to be replaced by a function vw_scanw using the <stdarg.h> interface. SEE ALSO
curses(3X), curs_getstr(3X), curs_printw(3X), scanf(3S) curs_scanw(3X)
Man Page