数值类型转换

这个crate提供了类型转换和已检查的类型转换。

更新内容

版本 1.2.1 更新内容（2022-07-25）

• 修复了在 Windows 下使用 rustc 1.64.0-nightly 构建的问题。

版本 1.2.0 更新内容（2021-11-24）

• 添加了以下特质，可以用于与其它类型转换特质相反方向的约束。
  • CastFrom
  • CheckedCastFrom
  • SaturatingCastFrom
  • WrappingCastFrom
  • OverflowingCastFrom
  • UnwrappedCastFrom

其他版本

其他版本详细信息请见 RELEASES.md。

快速示例

use az::{Az, OverflowingAs, WrappingAs};
use core::num::Wrapping;

// Panics on overflow with `debug_assertions`, otherwise wraps
assert_eq!(12i32.az::<u32>(), 12u32);

// Always wraps
let wrapped = 1u32.wrapping_neg();
assert_eq!((-1).wrapping_as::<u32>(), wrapped);
assert_eq!((-1).overflowing_as::<u32>(), (wrapped, true));

// Wrapping can also be obtained using `Wrapping`
assert_eq!((-1).az::<Wrapping<u32>>().0, wrapped);

支持从浮点数到整数的转换。数字四舍五入到零，但可以使用 Round 包装器将浮点数转换为整数，并以最接近的数进行四舍五入，奇偶数情况四舍六入五成双。

use az::{Az, CheckedAs, Round, SaturatingAs};
use core::f32;

assert_eq!(15.7.az::<i32>(), 15);
assert_eq!(Round(15.5).az::<i32>(), 16);
assert_eq!(1.5e20.saturating_as::<i32>(), i32::max_value());
assert_eq!(f32::NAN.checked_as::<i32>(), None);

实现其他类型的类型转换

要提供其他类型的类型转换，你应该实现 Cast 特质，如果需要，还应实现 CheckedCast、SaturatingCast、WrappingCast、OverflowingCast 和 UnwrappedCast 特质。对于所有使用泛型实现和前述特质利用的类型的 Az、CheckedAs、SaturatingAs、WrappingAs、OverflowingAs 和 UnwrappedAs 特质已经实现。

类型转换特性也可以应用于引用。这对于不实现 Copy 的昂贵类型非常有用。例如，如果你有一个不实现 Copy 的自定义整数类型，你可以实现如下示例中的类型转换。（I 可以是一个昂贵的类型，例如大整数，但在示例中它只是一个包装的 i32。）

use az::{Az, Cast};
use core::borrow::Borrow;

struct I(i32);
impl Cast<i64> for &'_ I {
    fn cast(self) -> i64 { self.0.cast() }
}

let owned = I(12);
assert_eq!(owned.borrow().az::<i64>(), 12);

使用 az 包

az 包可在 crates.io 获取。要在你的包中使用它，请在 Cargo.toml 中将其添加为依赖项

[dependencies]
az = "1.2"

该包需要 rustc 版本 1.31.0 或更高版本。

许可证

本包是自由软件：你可以根据以下任一许可证的条款重新分发和/或修改它

• Apache License, Version 2.0 或
• MIT License

自行选择。

贡献

除非你明确声明，否则任何有意提交给作品并包含在你中的贡献，根据 Apache License, Version 2.0 定义，应按上述方式双许可，不附加任何额外条款或条件。