[−][src]Trait funty::IsSigned

pub trait IsSigned: IsInteger + Neg {
    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.

Loading content...

Implementations on Foreign Types

impl IsSigned for i8[src]

impl IsSigned for i16[src]

impl IsSigned for i32[src]

impl IsSigned for i64[src]

impl IsSigned for i128[src]

impl IsSigned for isize[src]

Loading content...

Implementors

Loading content...