formZ SDK | 5.0 API Reference | System | Script Only
Description
Writes a floating point value to a string. The pre_width argument determines the minimum number of digits written for the integral part of the number. If the integral part has more digits, more are written. If it has less, blanks are written before. If zero or less is passed for the pre_width argument, the exact number of digits for the integral part are written. The post_width argument determines the minimum number of digits written for the fractional part of the number. If the fractional part has more digits, they are not written (i.e. the less significant digits are truncated). If it has less, zeroes are appended. If zero or less is passed for the post_width argument, the exact number of digits for the fractional part are written.
Parameters
str [Input]
string to be written to.
dval [Input]
the number to be written.
pre_width [Input]
the minimum number of digits to be written for the integral part.
post_width [Input]
the minimum number of digits to be written for the fractional part.
Returns
# of digits written, or negative if an error occurred.
Availability
5.0.0.0
See Also