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

> pure function pow(exponent: integer ): integer Raise this integer to the power of the given exponent. SQL compatible. Fails on integer overflow; so if resu

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

FUNCTION

# integer.pow

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

Raise this integer to the power of the given exponent. SQL compatible.

Fails on integer overflow; so if results outside integer range are expected, first convert to
`big_integer` (e.g. with `integer.to_big_integer()` or `big_integer(integer)`) and then use
`big_integer.pow()`.

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` — if the result is out of 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/integer/pow.html)Generated API reference, mirrored from the live docs