Crate int_cast 

This crate provides convenient casts between primitive integers.

The primary entry point is the extension trait IntCast, which will add casting methods to the primitive integer types. The casts provided are:

• x.cast(), only implemented when the cast is infallible,
• x.checked_cast(), returning None if the cast fails,
• x.strict_cast(), panicking if the cast fails,
• x.unchecked_cast(), undefined behavior if the cast fails,
• x.wrapping_cast(), never fails, wraps around, and
• x.saturating_cast(), never fails, saturates at the boundary.

Unlike x.into() and x.try_into() these casts can only convert between primitive integer types, and they support directly writing the target type using a turbofish, e.g. x.strict_cast::<usize>().

All cast traits are sealed meaning you may not implement them for custom types. This is intended, so that the behavior is predictable.

Features

If you enable the nonzero feature all traits are extended with implementations for core::num::NonZero types. Note that this requires a nightly compiler and uses the very much unstable core::num::ZeroablePrimitive.

Traits

BoundedCastFromInt

Conversion between integers, wrapping around or saturating at the target type’s boundaries.

CastFromInt

Infallible conversion between integers.

CheckedCastFromInt

Fallible conversion between integers.

IntCast

Extension trait for casting integers.