curs_scanw(3X)                 DG/UX R4.11MU05                curs_scanw(3X)


NAME
       cursscanw:  scanw, wscanw, mvscanw, mvwscanw, vwscanw - convert
       formatted input from a curses widow

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 vwscanw(WINDOW *win, char *fmt, valist varglist);

DESCRIPTION
       The scanw, wscanw and mvscanw routines correspond 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 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 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 interrogate the return value from the scanw, wscanw,
       mvscanw and  mvwscanw routines to determine the number of fields
       which were mapped in the call.

NOTES
       The header file <curses.h> automatically includes the header files
       <stdio.h> and <unctrl.h>.

   International Features
       Libcurses32 produces internationalized versions of the cursscanw:
       routines. The international versions of scanw, wscanw, mvscanw and
       mvwscanw are analogous to the libw32 version of scanf; vwscanw
       performs a wscanw using a variable argument list.  The international
       functions have been enhanced to handle process coded characters or
       strings.  [See scanf(3W).]

       A program using the internationalized versions must be compiled with
       the -lcurses32 and -lw32 options of cc, and the -lw32 option must be
       located just after the -lcurses32 option.

SEE ALSO
       curses(3X), cursgetstr(3X), cursprintw(3X), scanf(3S), scanf(3W).


Licensed material--property of copyright holder(s)