fscanf

scan input from a file

Synopsis:

#include <stdio.h>
int fscanf( FILE *fp, const char *format, ... );

Description:

The fscanf() function scans input from the file designated by fp, under control of the argument format. Following the format string is a list of addresses to receive values. The format string is described under the description of the scanf() function.

Returns:

The fscanf() function returns EOF when the scanning is terminated by reaching the end of the input stream. Otherwise, it returns the number of input arguments for which values were successfully scanned and stored. When a file input error occurs, the errno global variable may be set.

See also:

cscanf(), errno, scanf(), sscanf(), vcscanf(), vfscanf(), vscanf(), vsscanf()

Examples:

To scan a date in the form “Saturday April 18 1987”:

#include <stdio.h>

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

    in_data = fopen( "file", "r" );
    if( in_data != NULL ) {
      fscanf( in_data, "%s %s %d %d",
          weekday, month, &day, &year );
      printf( "Weekday=%s Month=%s Day=%d Year=%d\n",
          weekday, month, day, year );
      fclose( in_data );
    }
  }

Classification:

ANSI

Systems:

All (except DOS/PM)