ScanIn
- Updated2023-02-21
- 2 minute(s) read
ScanIn
int ScanIn (char formatString[], ...);
Purpose
Scans source data from the Standard Input and breaks the data into component parts according to format specifiers you specify in formatString. ScanIn then places the components into the target parameter. You can specify up to 29 target arguments.
ScanIn requires no argument for the source item. The Using the Formatting and Scanning Functions section includes a complete discussion of ScanIn.
 |
Note This function cannot convert "NaN" and "Inf" to equivalent double-precision numbers. |
Parameters
| Input | ||||||||||||
| Name | Type | Description | ||||||||||
| formatString | char [] | Contains format specifiers that appropriately describe the source and target data to be formatted. For the three scan functions, the target specifiers must be provided in the format string. The source specifier may be omitted, in which case the source is assumed to be %s (string). If a source data type other than string is desired, the format string must begin with the specifier of the desired source type, plus the "›" symbol, followed by the target specifiers. For example, the following calls are equivalent: x = Scan (s, "%d", i) x = Scan (s, "%s›%d", i) The following list includes common specifiers:
Because the data formatting functions can describe many complex formatting operations, refer to the Using the Formatting and Scanning Functions section to make sure you are using the proper format specifier for your application. |
||||||||||
| Output | ||||||||||||
| Name | Type | Description | ||||||||||
| target_s | ... | Specifies the variables in which to store the scanned items. You can specify up to 29 arguments, and you must separate the arguments with commas. Only the value of the first argument is shown at the bottom of the control after you execute the function panel. Refer to the Using the Formatting and Scanning Functions section for more information. |
||||||||||
Return Value
| Name | Type | Description |
| ItemsFormatted | int | Number of target format specifiers satisfied. To get the number of bytes scanned from the Standard Input, call NumFmtdBytes. If the return value is less than the number of target items, then the source did not contain the exact number and type of items specified in the format string. This function returns –1 to indicate an error in the format string or –2 to indicate an I/O error. If this value is –2, you can use GetFmtIOError to get more information about the type of error that occurred. |
Additional Information
Library: Formatting and I/O Library
Include file: formatio.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later