LabWindows/CVI

Content Type
Programming Language
Current manual
Table of Contents

scanf

scanf

int scanf (const char formatString[], ...);

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.
Output
Name Type Description
target_s ... Contains a pointer to the variable that receives the converted input from the standard input. If there are multiple arguments, you must 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

Example

Refer to userint\standardio.cws for an example of using the scanf function.

Was this information helpful?