Caché ObjectScript Reference
$ZPOWER


Returns the value of a number raised to a specified power.
Synopsis
$ZPOWER returns the value of the
num parameter raised to the
nth power.
Parameters
num
The number to be raised to a power. It can be integer or floating point, negative, positive, or zero. It can be a standard Caché number or an IEEE doubleprecision binary floatingpoint number (a
$DOUBLE number). It can be specified as a value, a variable, or an expression.
exponent
The exponent is a number that can be integer or floating point, negative, positive, or zero. It can be a standard Caché number or an IEEE doubleprecision binary floatingpoint number (a
$DOUBLE number). It can be specified as a numeric or string value, a variable, or an expression.
The following combinations of
num and
exponent result in an error:

If
num is negative,
exponent must be an integer. Otherwise an <ILLEGAL VALUE> error is generated.

If
num is 0,
exponent must be a positive number or zero. Otherwise an <ILLEGAL VALUE> or
<DIVIDE> error is generated.

Examples
The following example raises 2 to the first ten powers:
SET x=0
WHILE x < 10 {
SET rtn=$ZPOWER(2,x)
WRITE !,"The ",x," power of 2=",rtn
SET x=x+1 }
Copyright © 19972019 InterSystems Corporation, Cambridge, MA