Trait SaturatingNegAssign

pub trait SaturatingNegAssign {
    // Required method
    fn saturating_neg_assign(&mut self);
}

Negates a number in place, saturating at the numeric bounds instead of overflowing.

Required Methods

fn saturating_neg_assign(&mut self)

Implementations on Foreign Types

impl SaturatingNegAssign for i8

fn saturating_neg_assign(&mut self)

Negates a number in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} -x & \text{if} \quad x^2 > -2^{W-1}, \\ 2^{W-1} - 1 & \text{if} \quad x = -2^{W-1}, \end{cases} $$ where $W$ is Self::WIDTH.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingNegAssign for i16

fn saturating_neg_assign(&mut self)

Negates a number in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} -x & \text{if} \quad x^2 > -2^{W-1}, \\ 2^{W-1} - 1 & \text{if} \quad x = -2^{W-1}, \end{cases} $$ where $W$ is Self::WIDTH.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingNegAssign for i32

fn saturating_neg_assign(&mut self)

Negates a number in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} -x & \text{if} \quad x^2 > -2^{W-1}, \\ 2^{W-1} - 1 & \text{if} \quad x = -2^{W-1}, \end{cases} $$ where $W$ is Self::WIDTH.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingNegAssign for i64

fn saturating_neg_assign(&mut self)

Negates a number in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} -x & \text{if} \quad x^2 > -2^{W-1}, \\ 2^{W-1} - 1 & \text{if} \quad x = -2^{W-1}, \end{cases} $$ where $W$ is Self::WIDTH.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingNegAssign for i128

fn saturating_neg_assign(&mut self)

Negates a number in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} -x & \text{if} \quad x^2 > -2^{W-1}, \\ 2^{W-1} - 1 & \text{if} \quad x = -2^{W-1}, \end{cases} $$ where $W$ is Self::WIDTH.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

impl SaturatingNegAssign for isize

fn saturating_neg_assign(&mut self)

Negates a number in place, saturating at the numeric bounds instead of overflowing.

$$ x \gets \begin{cases} -x & \text{if} \quad x^2 > -2^{W-1}, \\ 2^{W-1} - 1 & \text{if} \quad x = -2^{W-1}, \end{cases} $$ where $W$ is Self::WIDTH.

Worst-case complexity

Constant time and additional memory.

Examples

See here.

Implementors