##### Synopsis

    #include <cross_studio_io.h>
    int debug_fscanf(DEBUG_FILE *file, const char *format, ...);

##### Description

debug_fscanf reads from the file, under control of the string pointed to by format that specifies how subsequent arguments are converted for input. The actual formatting is performed on the host by CrossStudio and therefore debug_fscanf is very small and consumes almost no code and data space, only the overhead to call the function.

If there are insufficient arguments for the format, the behavior is undefined. If the format is exhausted while arguments remain, the excess arguments are evaluated but are otherwise ignored.

debug_fscanf returns number of characters read, or a negative value if an output or encoding error occurred.

##### Portability

debug_fscanf is an extension provided by CrossWorks C.