ToIntegerPower and ToPower (Float functions)

Raise number to an integer power (Float class)

Template:Float:ToPower subtitle

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.

Syntax

%number = float:ToIntegerPower( exponent)

%number = float: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)}

See also

Float class String class Unicode class	List of Float methods List of String methods List of Unicode methods List of Intrinsic methods	Float methods syntax String methods syntax Unicode methods syntax
Notation conventions for methods

List of intrinsic Float methods