##### Synopsis

    #include <stdio.h>
    int vscanf(const char *format, va_list arg);

##### Description

vscanf reads input from the standard input stream under control of the string pointed to by format that specifies the admissible input sequences and how they are to be converted for assignment, using subsequent arguments as pointers to the objects to receive the converted input. Before calling vscanf, arg must be initialized by the va_start macro (and possibly subsequent va_arg calls). vscanf does not invoke the va_end macro.

If there are insufficient arguments for the format, the behavior is undefined.

vscanf returns the value of the macro EOF if an input failure occurs before any conversion. Otherwise, vscanf returns the number of input items assigned, which can be fewer than provided for, or even zero, in the event of an early matching failure.

##### Notes

vscanf is equivalent to scanf with the variable argument list replaced by arg.

##### Portability

vscanf conforms to ISO/IEC 9899:1990 (C90) and ISO/IEC 9899:1999 (C99).

##### See Also

Format strings for scanf functions