ToIntegerPower and ToPower (Float functions)
These intrinsic functions return a number that is the method object value raised to the power specified by the method argument. The argument value is initially rounded to the nearest integral value.
ToPower is a synonym for ToIntegerPower.
Available as of version 7.3 of the Sirius Mods, the ToIntegerPower and ToPower functions are object-oriented versions of the $RXPI function.
ToPower syntax
%value = number:toPower(exponent)
Syntax terms
- %value
- A numeric variable to contain the method result.
- number
- A Float value.
- exponent
- A Float value, which is rounded to the nearest integer.
Usage Notes
- If number is 0 and exponent is less than or equal to 0, the request is cancelled.
Examples
The following statement returns “3:toPower(5) = 243”.
printText {~} = {3:toPower(5)}
The following statement returns “-.1:toPower(2.8) is -0.001”.
printText {~} is {-.1:toPower(2.8)}
The following statement returns “2:toIntegerPower(-2.2) is 0.25”.
printText {~} is {2:toIntegerPower(-2.2)}