Trait Signed

pub trait Signed: Integral + Neg {
    // Required methods
    fn checked_abs(self) -> Option<Self>;
    fn wrapping_abs(self) -> Self;
    fn overflowing_abs(self) -> (Self, bool);
    fn abs(self) -> Self;
    fn signum(self) -> Self;
    fn is_positive(self) -> bool;
    fn is_negative(self) -> bool;
}

Declare that a type is a signed integer.

Required Methods

fn checked_abs(self) -> Option<Self>

Checked absolute value. Computes self.abs(), returning None if self == MIN.

fn wrapping_abs(self) -> Self

Wrapping (modular) absolute value. Computes self.abs(), wrapping around at the boundary of the type.

The only case where such wrapping can occur is when one takes the absolute value of the negative minimal value for the type this is a positive value that is too large to represent in the type. In such a case, this function returns MIN itself.

fn overflowing_abs(self) -> (Self, bool)

Computes the absolute value of self.

Returns a tuple of the absolute version of self along with a boolean indicating whether an overflow happened. If self is the minimum value (e.g., iN::MIN for values of type iN), then the minimum value will be returned again and true will be returned for an overflow happening.

fn abs(self) -> Self

Overflow behavior

The absolute value of iN::min_value() cannot be represented as an iN, and attempting to calculate it will cause an overflow. This means that code in debug mode will trigger a panic on this case and optimized code will return iN::min_value() without a panic.

fn signum(self) -> Self

Returns a number representing sign of self.

• 0 if the number is zero
• 1 if the number is positive
• -1 if the number is negative

fn is_positive(self) -> bool

Returns true if self is positive and false if the number is zero or negative.

fn is_negative(self) -> bool

Returns true if self is negative and false if the number is zero or positive.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl Signed for i8

fn checked_abs(self) -> Option<Self>

fn wrapping_abs(self) -> Self

fn overflowing_abs(self) -> (Self, bool)

fn abs(self) -> Self

fn signum(self) -> Self

fn is_positive(self) -> bool

fn is_negative(self) -> bool

impl Signed for i16

fn checked_abs(self) -> Option<Self>

fn wrapping_abs(self) -> Self

fn overflowing_abs(self) -> (Self, bool)

fn abs(self) -> Self

fn signum(self) -> Self

fn is_positive(self) -> bool

fn is_negative(self) -> bool

impl Signed for i32

fn checked_abs(self) -> Option<Self>

fn wrapping_abs(self) -> Self

fn overflowing_abs(self) -> (Self, bool)

fn abs(self) -> Self

fn signum(self) -> Self

fn is_positive(self) -> bool

fn is_negative(self) -> bool

impl Signed for i64

fn checked_abs(self) -> Option<Self>

fn wrapping_abs(self) -> Self

fn overflowing_abs(self) -> (Self, bool)

fn abs(self) -> Self

fn signum(self) -> Self

fn is_positive(self) -> bool

fn is_negative(self) -> bool

impl Signed for i128

fn checked_abs(self) -> Option<Self>

fn wrapping_abs(self) -> Self

fn overflowing_abs(self) -> (Self, bool)

fn abs(self) -> Self

fn signum(self) -> Self

fn is_positive(self) -> bool

fn is_negative(self) -> bool

impl Signed for isize

fn checked_abs(self) -> Option<Self>

fn wrapping_abs(self) -> Self

fn overflowing_abs(self) -> (Self, bool)

fn abs(self) -> Self

fn signum(self) -> Self

fn is_positive(self) -> bool

fn is_negative(self) -> bool

Implementors