vscanf()

Scan input from a file

Synopsis:

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

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

Library:

libc

Description:

The vscanf() function scans input from the file designated by stdin, under control of the argument format. For information about the format string, see the description of scanf().

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

Returns:

EOF when the scanning is stopped by reaching the end of the input stream before storing any values, or the number of input arguments for which values were successfully scanned and stored.

Errors:

If an error occurs, errno indicates the type of error.

Examples:

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

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

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

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

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

Classification:

Unix

See also:

errno, fscanf(), scanf(), sscanf(), va_arg(), va_end(), va_start(), vsscanf()