#wrapping #arithmetic #wrapper #offers #checked #saturating #addresses

arith_wrappers

Rust’s std offers the Wrapping type for “intentionally wrapping” arithmetic, but curiously does not provide analagous implementations for intentionally saturating, checked, overflowing or panicking arithmetic. This crate addresses these missing wrappers as well as re-exports std’s Wrapping type for completeness and consistency.

2 unstable releases

0.2.0 Apr 16, 2022
0.1.0 Jan 31, 2021

#1426 in Math


Used in ranged_type

MIT/Apache

10KB
142 lines

arith_wrappers

Rust's std offers the Wrapping type for "intentionally wrapping" arithmetic, but curiously does not provide analogous implementations for intentionally saturating, checked, overflowing or panicking arithmetic. This crate addresses these missing wrappers as well as exports an alternative to std's Wrapping, providing a consistent interface across all wrappers in this crate as well as some benefits like trait-enforced access to T::MIN and T::MAX where T implements any of the wrappers defined in this crate.

Without these wrappers, performing correct arithmetic is verbose, error-prone and pedantic, leading to ignoring the problems altogether or hard-to-maintain implementations.

This crate is at a very early pre-alpha stage of implementation and should be considered a PoC.

License

Licensed under either:

  • MIT license (see LICENSE-MIT file)
  • Apache License, Version 2.0 (see LICENSE-APACHE file) at your option.

Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.7–1.3MB
~28K SLoC