Integration Server 10.3 | Built-In Services Reference Guide | Math Folder | Summary of Elements in this Folder | pub.math:subtractFloats
 
pub.math:subtractFloats
WmPublic. Subtracts one floating point number (represented as a String) from another and returns the difference.
Input Parameters
num1
String Number (floating point number represented as a String).
num2
String Number (floating point number represented as a String) to subtract from num1.
precision
String Optional. Number of decimal places to which the difference will be rounded. The default value is null.
The precision parameter, if specified, will override the behavior set by the watt.server.math.floatOperation.mode property. For information about the watt.server.math.floatOperation.mode property, see the webMethods Integration Server Administrator’s Guide.
Output Parameters
value
String Difference of num1 - num2. If a difference cannot be produced, value contains one of the following:
Value
Description
Infinity
The computation produces a positive value that overflows the representable range of a float type.
-Infinity
The computation produces a negative value that overflows the representable range of a float type.
0.0
The computation produces a value that underflows the representable range of a float type (for example, subtracting a number from infinity).
NaN
The computation produces a value that cannot be represented as a number (for example, the result of an illegal operation such as multiplying zero by zero or any operation that uses NaN as input, such as 10.0 - NaN = NaN).
Usage Notes
Make sure the strings that are passed to the service in num1andnum2 are in a locale-neutral format (that is, using the pattern -####.##). Passing locally formatted strings may result in unexpected results. For example, calling pub.math:addFloats in a German locale with the arguments 1,23 and 2,34 will result in the value 357, not 3.57 or 3,57.
Use the watt.server.math.floatOperation.mode property to specify whether the pub.math:subtractFloats service return the exact result of an operation involving two floating point numbers, the result as calculated by the JVM, or the result based on a fixed number of decimal places. For more information about the watt.server.math.floatOperation.mode property, see webMethods Integration Server Administrator’s Guide