Function pow
Calculates the power of x to y, x ^ y.
Matrix exponentiation is supported for square matrices x, and positive
integer exponents y.
For cubic roots of negative numbers, the function returns the principal
root by default. In order to let the function return the real root,
js can be configured with config({predictable: true}).
To retrieve all cubic roots of a value, use cbrt(x, true).
Syntax
pow(x, y)
Parameters
| Parameter | Type | Description |
|---|---|---|
x |
number | BigNumber | Complex | Array | Matrix | The base |
y |
number | BigNumber | Complex | The exponent |
Returns
| Type | Description |
|---|---|
| number | BigNumber | Complex | Array | Matrix | The value of x to the power y |
Examples
pow(2, 3); // returns number 8
var a = complex(2, 3);
pow(a, 2) // returns Complex -5 + 12i
var b = [[1, 2], [4, 3]];
pow(b, 2); // returns Array [[9, 8], [16, 17]]