Creates a string from a double number using a proper format.
|inIntegerDigitCount||Integer||0 - 1000||How many characters the integer part of the input real should have at least|
|inFractionalDigitCount||Integer||0 - 100||How many characters the fractional part of the input real should have|
|inDecimalMark||String||The symbol used to separate the integer part from the fractional part of the number|
|inTrailingCharacter||String||Defines the trailing character|
|inForceSignPrinting||Bool||Forces printing the sign of the number even if the number is positive|
|inSuffix||String||Defines a suffix. Generally it is an unit of value (e.g. mm)|
inDouble = 2.7182818284590452
inIntegerDigitCount = 2
inFractionalDigitCount = 2
inDecimalMark = ","
inTrailingCharacter = "0"
inForceSignPrinting = False
inSuffix = "..."
|outString = "02,72..."|
In the first example desired integer digit count equals 2 as entered in inIntegerDigitCount, so the filter attaches character in inTrailingCharacter (zero)
at the beginning of the result outString. Decimal mark is set as a comma and the number of fractional digits as 2.
The result string ends with ellipsis defined in inSuffix and the result is "02,72...".
Note that the second digit was rounded up to "2" due to the succeeding digit.
inDouble = 77
inIntegerDigitCount = 1
inFractionalDigitCount = 1
inDecimalMark = "."
inTrailingCharacter = "#"
inForceSignPrinting = True
inSuffix = "°"
|outString = "+77.0°"|
The second example demonstrates formatting with one integer digit and one fractional. Note that the integer part of the formatted number is less
than the value, but it doesn't affect to this part (unlike fractional part which can cuts off excessing digits).
Trailing character (#) doesn't affect to anything, because desired integer digit count described by inIntegerDigitCount is one (the same effect would be for zero).
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
|DomainError||inDecimalMark has to be a single character in FormatDoubleToString.|
|DomainError||inTrailingCharacter has to be a single character in FormatDoubleToString.|
This filter is available on Basic Complexity Level.