This crate provides checked, overflowing and static casts.
```rust use core::num::Wrapping;
// Panics on overflow with debug_assertions, otherwise wraps.
let a: u32 = az::cast(12i32);
assert_eq!(a, 12);
// Always wraps.
let b: u32 = az::wrappingcast(-1i32);
asserteq!(b, u32::maxvalue());
let c = az::overflowingcast::
// Wrapping can also be obtained using Wrapping
let d: Wrapping
Conversions from floating-point to integers are also supported.
Numbers are rounded towards zero, but the [Round] wrapper can be
used to convert floating-point numbers to integers with rounding to
the nearest, with ties rounded to even.
```rust use az::Round; use core::f32;
asserteq!(az::cast::<_, i32>(15.7), 15); asserteq!(az::cast::<_, i32>(Round(15.5)), 16); asserteq!(az::saturatingcast::<_, i32>(1.5e20), i32::maxvalue()); asserteq!(az::checked_cast::<_, i32>(f32::NAN), None); ```
The az crate is available on crates.io. To use it in your crate, add it as a dependency inside [Cargo.toml]:
toml
[dependencies]
az = "0.1.0"
This crate is free software: you can redistribute it and/or modify it under the terms of either
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache License, Version 2.0, shall be dual licensed as above, without any additional terms or conditions.