pub struct CheckedArithmetic<Kind = Checked>(/* private fields */);
Expand description

Arithmetic on an integer type (e.g., i32) that checks overflow and other failure conditions for all operations.

As an example, this type implements Arithmetic for all built-in integer types with a definite size (u8, i8, u16, i16, u32, i32, u64, i64, u128, i128).

The type param defines how negation should be performed; it should be one of Checked (default value), Unchecked or NegateOnlyZero. See the docs for these types for more details.

Implementations§

source§

impl<Kind> CheckedArithmetic<Kind>

source

pub const fn new() -> Self

Creates a new arithmetic instance.

Trait Implementations§

source§

impl<T, Kind> Arithmetic<T> for CheckedArithmetic<Kind>where T: Clone + PartialEq + Zero + One + CheckedAdd + CheckedSub + CheckedMul + CheckedDiv, Kind: CheckedArithmeticKind<T>, usize: TryFrom<T>,

source§

fn add(&self, x: T, y: T) -> Result<T, ArithmeticError>

Adds two values. Read more
source§

fn sub(&self, x: T, y: T) -> Result<T, ArithmeticError>

Subtracts two values. Read more
source§

fn mul(&self, x: T, y: T) -> Result<T, ArithmeticError>

Multiplies two values. Read more
source§

fn div(&self, x: T, y: T) -> Result<T, ArithmeticError>

Divides two values. Read more
source§

fn pow(&self, x: T, y: T) -> Result<T, ArithmeticError>

Raises x to the power of y. Read more
source§

fn neg(&self, x: T) -> Result<T, ArithmeticError>

Negates a value. Read more
source§

fn eq(&self, x: &T, y: &T) -> bool

Checks if two values are equal. Note that equality can be a non-trivial operation; e.g., different numbers may be equal as per modular arithmetic.
source§

impl<Kind> Clone for CheckedArithmetic<Kind>

source§

fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl<Kind: Debug> Debug for CheckedArithmetic<Kind>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl<Kind> Default for CheckedArithmetic<Kind>

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<T, Kind> OrdArithmetic<T> for CheckedArithmetic<Kind>where Self: Arithmetic<T>, T: PartialOrd,

source§

fn partial_cmp(&self, x: &T, y: &T) -> Option<Ordering>

Compares two values. Returns None if the numbers are not comparable, or the comparison result otherwise.
source§

impl<Kind> Copy for CheckedArithmetic<Kind>

Auto Trait Implementations§

§

impl<Kind> RefUnwindSafe for CheckedArithmetic<Kind>where Kind: RefUnwindSafe,

§

impl<Kind> Send for CheckedArithmetic<Kind>where Kind: Send,

§

impl<Kind> Sync for CheckedArithmetic<Kind>where Kind: Sync,

§

impl<Kind> Unpin for CheckedArithmetic<Kind>where Kind: Unpin,

§

impl<Kind> UnwindSafe for CheckedArithmetic<Kind>where Kind: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T, A> ArithmeticExt<T> for Awhere A: Arithmetic<T>,

source§

fn without_comparisons(self) -> FullArithmetic<T, Self>

Combines this arithmetic with a comparison function that assumes any two values are incomparable.
source§

fn with_natural_comparison(self) -> FullArithmetic<T, Self>where T: PartialOrd,

Combines this arithmetic with a comparison function specified by the PartialOrd implementation for T.
source§

fn with_comparison( self, comparison: fn(_: &T, _: &T) -> Option<Ordering> ) -> FullArithmetic<T, Self>

Combines this arithmetic with the specified comparison function.
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.