Trait malachite_base::num::arithmetic::traits::SaturatingPowAssign

pub trait SaturatingPowAssign<RHS = Self> {
    fn saturating_pow_assign(&mut self, exp: RHS);
}

Raises a number to a power in place, saturating at the numeric bounds instead of overflowing.

Required Methods

fn saturating_pow_assign(&mut self, exp: RHS)

Implementations on Foreign Types

impl SaturatingPowAssign<u64> for u8

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for u16

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for u32

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for u64

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for u128

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for usize

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for i8

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for i16

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for i32

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for i64

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for i128

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingPowAssign<u64> for isize

fn saturating_pow_assign(&mut self, exp: u64)

Raises a number to a power, in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} x^y & \text{if} \quad m \leq x^y \leq M, \\ M & \text{if} \quad x^y > M, \\ m & \text{if} \quad x^y < m, \end{cases} $$ where $m$ is Self::MIN and $M$ is Self::MAX.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

Implementors