FmtOut
- Updated2023-02-21
- 2 minute(s) read
FmtOut
int FmtOut (char formatString[], ...);
Purpose
Formats the source1, . . ., sourcen arguments according to descriptions in the formatString argument. You can specify up to 29 source arguments. FmtOut writes the result of the formatting to the Standard I/O window.
The Using the Formatting and Scanning Functions section includes a complete discussion of FmtOut.
Parameters
| Input | ||||||||||||
| Name | Type | Description | ||||||||||
| formatString | char [] | Contains format specifiers that appropriately describe the source and target data to be formatted. For the three format functions, the source specifiers must be provided in the format string. You may omit the target specifier, in which case the target is assumed to be %s (string). If a target data type other than string is desired, the format string must begin with the specifier of the desired target type, followed by the "‹" symbol, followed by the source specifiers. For example, the following calls are equivalent: x = Fmt (s, "%d", k) x = Fmt (s, "%s‹%d", k) 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. |
||||||||||
| source_s | ... | Specifies one or more arguments to convert and write to the Standard Output. Each argument must match its corresponding type specifier in the format string. You can specify up to 29 arguments, and you must separate the arguments with commas. | ||||||||||
Return Value
| Name | Type | Description |
| ItemsFormatted | int | Number of source items successfully written to the Standard Output. To get the number of bytes written to the Standard Output, call NumFmtdBytes. 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