The Evaluate built-in Glb.Financial method allows the actual calculation required to be specified in the first parameter to the method. In all other respects it behaves as if that calculation method had been called directly.
The action parameter is used to specify the method to call, and can be dynamically set to any of the following Glb.Financial member methods:
Failure behavior
If the name of the method returned by the first parameter is not a valid method of Glb.Financial, other than Evaluate, the method will set Glb.Status to “*****” and return 0.
If assigning the result to a signed number-primitive variable, truncation of significant digits occurs without warning if it is not of a sufficient length.
Syntax
Glb.Financial::Evaluate( action : stringExpression, futureValue : numericExpression, interestRate : numericExpression, timeUnits : numericExpression) : numericLiteral
Owner
Glb.Financial.
Return type
A numeric literal, length and decimal properties of which can vary. As a guideline, the internal intermediate work files are stored as USAGE COMP-2, and rounded on output.
Parameters
action
A string specifying the Glb.Financial member method to call.
futureValue
A numeric expression specifying the future value, Sn. This expression is assumed to be of length 12, with 3 decimal places. If this expression does not have these property values, ensure that truncation of significant digits does not occur.
interestRate
A numeric expression specifying the interest rate percentage, i, to be applied per time unit. This expression is assumed to be of length 10, with 8 decimal places. It must be positive and is interpreted as a percentage.
timeUnits
A numeric expression specifying the number of time units, N. This expression is assumed to be length 12, with 6 decimal places.