Integration Server 10.3 | Built-In Services Reference Guide | Math Folder | Summary of Elements in this Folder | pub.math:divideFloats
 
pub.math:divideFloats
WmPublic. Divides one floating point number (represented as a String) by another (num1/num2) and returns the quotient.
Input Parameters
num1
String Number (floating point number represented as a String) that is the dividend.
num2
String Number (floating point number represented as a String) that is the divisor.
precision
String Optional. Number of decimal places to which the quotient 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 The quotient of num1 / num2. If a quotient 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, dividing a number by infinity).
NaN
The computation produces a value that cannot be represented as a number (for example, the result of an illegal operation such as dividing 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:divideFloats 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 information about the watt.server.math.floatOperation.mode property, see the webMethods Integration Server Administrator’s Guide.