PrecisionEvaluate
Evaluates one or more string expressions dynamically from left to right using BigDecimal precision arithmetic.
Note, this is provided for compat. It acutally works the same as evaluate() and will use the same high precision math setting that Boxlang is configured with. BoxLang will always use high precision math by default.
Method Signature
PrecisionEvaluate(expression=[string])Arguments
expression
string
true
Expression to evaluate. String expressions can be complex.
Examples
Description
Evaluates one or more string expressions dynamically from left to right, using BigDecimal precision arithmetic to calculate arbitrary-precision arithmetic expressions.
Returns
An object containing the result of the evaluations. The result is the value returned by the rightmost expression.
Category
Mathematical functions, Dynamic evaluation functions
Function Syntax
Parameters
string_expression1, string_expression2, ...
Expressions to evaluate. Expressions are evaluated from left to right, and the result of an expression on the left can be used by an expression on the right.
Usage
precisionEvaluate calculates arbitrarily long decimal values using BigDecimal precision arithmetic. BigDecimal arithmetic accepts and generates decimal numbers of any length without using exponential notation.
Precision arithmetic applies to addition, subtraction, multiplication, and division. Exponentiation (^), modulus (MOD or %), and integer division use normal integer or floating-point arithmetic instead of returning BigDecimal values.
This function differs from evaluate in its use of BigDecimal precision arithmetic. If an expression contains a single- or double-quotation mark, the mark must be escaped. If an expression such as 1/3 results in an infinitely repeating decimal value, the decimal portion is limited to 20 digits.
For better processing efficiency, do not put arithmetic expressions in quotation marks. precisionEvaluate( a * b ) compiles more efficiently than precisionEvaluate( "a * b" ), although both forms produce the same result.
Example
Output:
Additional Examples
precisionEvaluate of 1/3 plus 5
1/3 is calculated then 5 is added to the total. Display is limited to 20 threes.
Result: 5.333333333333333333333333333333333
precisionEvaluate of 1/(7*12)
Calculate 1 divided by the product of 7 x 12
Result: 0.0119047619047619047619047619047619
Related
Last updated
Was this helpful?