int Fmt (void *target, char *formatString, source1, . . . , source
Formats the source1, . . . , sourcen arguments according to descriptions in the formatString argument.
Fmt places the result of the formatting into the target argument, which you must pass by reference. The return value indicates how many source format specifiers were satisfied. If the format string is invalid, the return value is –1. The Using the Formatting and Scanning Functions section includes a complete discussion of Fmt.
Input | ||||||||||||
Name | Type | Description | ||||||||||
formatString | string | 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. |
||||||||||
source1, . . . , sourcen | Types must match | Specifies one or more arguments that are to be converted and written to the target. Each argument must match its corresponding type specifier in the format string. There may be up to 14 arguments. They must be separated by commas. | ||||||||||
Output | ||||||||||||
Name | Type | Description | ||||||||||
target | Type must match | Specifies the variable in which the formatted items are stored. Refer to the Using the Formatting and Scanning Functions section for more information. |
Name | Type | Description |
n | integer | Number of source format specifiers satisfied. To get the number of bytes placed into the target item, call NumFmtdBytes. Fmt returns –1 to indicate an error in the format string. |