_Str3 Function | |
Convert a numeric expression to a string of specific length and decimal places.
Namespace:
XSharp.RT
Assembly:
XSharp.RT (in XSharp.RT.dll) Version: 2.21
Syntax FUNCTION _Str3(
f AS FLOAT,
dwLen AS DWORD,
dwDec AS DWORD
) AS STRING
public static string _Str3(
Float f,
uint dwLen,
uint dwDec
)
Request Example
View SourceParameters
- f
- Type: Float
- dwLen
- Type: DWord
- dwDec
- Type: DWord
Return Value
Type:
StringA string with DOT as decimal separator.
Remarks
Str3() is a typed version of the Str() numeric function where all three arguments are mandatory. See Str() for a detailed description.
Examples
These examples show how to use Str3() to change a number to a string:
1LOCAL fNumber AS FLOAT
2fNumber := 123.45
3? Str3(fNumber, 10, 1)
4? Str3(fNumber * 10, 7, 2)
5? Str3(fNumber * 10, 12, 4)
This functions returns a string of all asterisks when the Decimals parameter is > 0 and the Decimals parameter is > Length-2.
Also a string of all asterisks is returned when the number does NOT fit into the allocated space.
Example:
1? Str(9,6,6) => "******"
2? Str(9,6,5) => "******"
3? Str(9,6,4) => "9.0000"
4? Str(9,6,3) => " 9.000"
5? Str(10,6,6) => "******"
6? Str(10,6,5) => "******"
7? Str(10,6,4) => "******"
8? Str(10,6,3) => "10.000"
See Also