#conversion #saturation #float #integer #convert

saturate

Rust traits for saturating conversion between numeric types

1 unstable release

0.1.0 May 17, 2024

#1710 in Rust patterns

Download history 113/week @ 2024-05-13 30/week @ 2024-05-20 12/week @ 2024-05-27

155 downloads per month

MIT/Apache

20KB
365 lines

saturate   Test StatusCrate VersionRust Version

This crate provides a set of traits for saturating conversion between different numeric types.

The trait SaturatingFrom is implemented by default for all standard numeric types. A blanket implementation of SaturatingInto is also provided, mirroring the standard library's From and Into traits.

Example

use saturate::{SaturatingFrom, SaturatingInto};

assert_eq!(0, u8::saturating_from(-26));
assert_eq!(u32::MAX, i64::MAX.saturating_into());
assert!(f32::saturating_from(u128::MAX).is_infinite()); // out of range => infinity
assert_eq!(u8::MAX, 300.0.saturating_into());

Licence

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps