vscanf()

scan input from a file

Synopsis:

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

int vscanf( const char *format,
            va_list arg );

Description:

The vscanf() function scans input from the file designated by stdin, under control of the argument format. The format string is described under the description of the scanf() function.

The vscanf() function is equivalent to the scanf() function, with a variable argument list replaced with arg, which has been initialized using the va_start() macro.

Returns:

EOF when the scanning is terminated by reaching the end of the input stream. Otherwise, the number of input arguments for which values were successfully scanned and stored is returned.

Examples:

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

void find( char *format, ... )
  {
    va_list arglist;

    va_start( arglist, format );
    vscanf( format, arglist );
    va_end( arglist );
  }

void main()
  {
    int day, year;
    char weekday[10], month[12];

    find( "%s %s %d %d",
        weekday, month, &day, &year );
    printf( "\n%s, %s %d, %d\n",
        weekday, month, day, year );
  }

Classification:

WATCOM

See also:

cscanf(), fscanf(), scanf(), sscanf(), va_arg(), va_end(), va_start(), vcscanf(), vfscanf(), vsscanf()