Admin Production ni-theme
Current Publication

fscanf

LabWindows/CVI

fscanf

int fscanf (FILE *stream, const char formatString[], ...);

Purpose

Reads input from the specified stream and converts it into a series of values according to the specifications of the formatting string.

Parameters

Input
Name Type Description
stream FILE * Contains a pointer to the stream from which data is scanned.
formatString const char [] Contains the format string that specifies the admissible input sequences and how they are converted for assignment. Use standard ANSI C format specifiers. If insufficient arguments exist for the format, the behavior is undefined. If the format is exhausted while arguments remain, the excess arguments are evaluated but are otherwise ignored.
Note Note  For more information about the standard ANSI C format specifiers, refer to an external ANSI C reference.
Output
Name Type Description
target_s ... Contains a pointer to the object that receives the converted input from the specified stream. If there are multiple arguments, separate the arguments by commas.

Return Value

Name Type Description
ItemsFormatted int Contains the number of parameters successfully matched and formatted or EOF (-1) in case of an invalid input. This value might be less than the number of parameters you pass in for matching in the following cases:

  • The input or the format string contains fewer elements than parameters passed in.
  • The function could not match one of the parameters.
If an error occurs, this function sets errno to a nonzero value.

Additional Information

Library: ANSI C Library

Include file: ansi_c.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later