arranged

A Rust ranged-type 库。

arranged 是 Rust 的范围类型 crate。注意：此 crate 目前处于预 alpha 阶段，仍在建设中。

目标

arranged 是一个探索性实现，用于 Rust 中的安全默认算术值操作——任何算术操作都不应因运行时溢出而失败（panic）（除非用户明确请求 panic）——同时通过传统的算术运算符（+，-，*，/，% 等）来支持易用性。

设计哲学

范围类型尽可能以零运行时开销设计，否则以最小运行时开销设计

• 两个未包装的范围类型之间的所有算术操作边界检查都发生在编译时
• mem::size_of::<Ranged<T>>() == mem::size_of::<T>()（即范围是零大小的）。性能和缓存友好，尤其是在处理大量值时

行为

• Ranged<T> {op} Ranged<U> 产生 Range<V> 并在编译时进行边界检查（其中 {op} 代表一个算术运算，而 T，U 和 V 代表相同机器字类型的值范围）。任何可能的溢出都会导致编译失败。
• Ranged<T> {op} *Wrapper<Ranged<U>> 生成 Ranged<T>，运行时进行范围检查并按照 * 策略处理溢出，其中 * 是检查、溢出、恐慌、饱和或包装溢出策略之一。
• Ranged<T> {op} {标量} 因为策略未指定而无法编译
• Ranged<T> {op} *Wrapper<{标量}> 生成 Ranged<T>，运行时进行范围检查并按照 * 策略处理溢出
• {标量} {op} Ranged<T> 因为策略未指定而无法编译
• {标量} {op} *Wrapper<{标量}> 生成 *Wrapper<{标量}>，运行时进行范围检查并按照 * 策略处理溢出
• {标量} {op} *Wrapper<Ranged<T>> 生成 *Wrapper<Ranged<T>>，运行时进行范围检查并按照 * 策略处理溢出
• *Wrapper<Ranged<T>> {op} Ranged<U> 生成 *Wrapper<Ranged<V>>，编译时进行范围检查并按照 * 策略处理溢出
• *Wrapper<Ranged<T>> {op} †Wrapper<Ranged<U>> 生成 *Wrapper<Ranged<T>>，运行时进行范围检查并按照 * 策略处理溢出。† 策略被忽略。
• *Wrapper<Ranged<T> {op} {scalar} 生成 *Wrapper<"Ranged<T>>，运行时检查边界，并根据 * 策略处理溢出。

// Create a `u8`-based `RangeInclusive`-style type limited to `1..=100`, set to the value 42
let my_ranged_value = Ranged::<RiU8<1, 100>>::from(42);