vfwscanf(3S)

NAME
     vfwscanf: vfwscanf, vwscanf, vswscanf - convert formatted wide-character
     input

SYNOPSIS
     #include <stdarg.h>
     #include <stdio.h>
     #include <wchar.h>
     int vfwscanf(FILE * restrict stream, const wchar_t * restrict format, va_list arg);
     int vwscanf(const wchar_t * restrict format, va_list arg);
     int vswscanf(const char * restrict s, const wchar_t * restrict format, va_list arg);

DESCRIPTION
     vfwscanf reads from the stream stream.

     vwscanf reads from the standard input stream stdin.

     vswscanf reads from the wide-character string *s.

     Each function reads wide-characters, interprets them according to a
     format, and stores the results in its arguments.

     The vwscanf(), vfwscanf() and vswscanf() functions are the same as
     wscanf(), fwscanf() and swscanf() respectively, except that instead of
     being called with a variable number of arguments, they are called with an
     argument list as defined by <stdarg.h>.

     These functions do not invoke the va_end macro.

EXAMPLES
     The following example shows the use of the vfwscanf function.

          #include <stdarg.h>
          #include <stdio.h>
          #include <wchar.h>

          void input(wchar_t *format, ...);
          {
               va_list args;
               va_start(args, format);
               vfwscanf(stdin, format, args);
               va_end(args);
          }

NOTES
     These functions are supported in n32 and 64 bit C Libraries for IRIX
     6.5.18 and later versions as one of C99 features.
SEE ALSO
     fwscanf(3S), stdarg(5), stdio(3S), widec(3S).

DIAGNOSTICS
     These routines return the number of successfully matched and assigned
     input items; this number can be zero in the event of an early matching
     failure between an input character and the control string.  If the input
     ends before the first matching failure or conversion, EOF is returned.

     In addition, all forms of fwscanf() may fail if:

     [EILSEQ]
          Input byte sequence does not form a valid character.
     [EINVAL]
          There are insufficient arguments.