LabWindows/CVI

Content Type
Programming Language
Current manual
Table of Contents

vscanf

vscanf

int vscanf (const char formatString[], va_list target_s);

Purpose

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

Parameters

Input
Name Type Description
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.
target_s va_list Contains a variable argument list initialized by the va_start macro and possibly subsequent va_arg calls. Though the list is an input parameter, it contains one or more target variables that receive the formatted output values.

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

Was this information helpful?

Previous

sscanf

Previous

sscanf