# big_integer.pow · Rell standard library · Chromia Docs (concept)

> pure function pow(exponent: integer ): big_integer Raise this big_integer to the power of the given exponent. SQL compatible. Note that: the exponent canno

Source: https://docs.chromia.com/pages/rell-stdlib/-rell-system-library/root/big_integer/pow/

FUNCTION

# big\_integer.pow

```signature
pure function pow(exponent: integer): big_integer
```

Raise this `big_integer` to the power of the given exponent. SQL compatible.

Note that:

* the exponent cannot be negative
* if the exponent is 0, the result is 1
* if the exponent is 1, the result is the original value

**Parameters**

* **exponent** — the exponent

**Throws**

* `exception` — on overflow, i.e. if the result is out of `big_integer` range

Since 0.13.6

[View this page on docs.chromia.com](https://docs.chromia.com/pages/rell-stdlib/-rell%20-system%20-library/%5Broot%5D/big_integer/pow.html)Generated API reference, mirrored from the live docs