option-operations

option-operations provides traits and auto-implementations to improve arithmetic operations usability when dealing with Options.

Example

Dealing with two Options, can lead to verbose expressions:

``` rust let lhs = Some(1u64); let rhs = Some(u64::MAX);

asserteq!( lhs.zip(rhs).map(|(lhs, rhs)| lhs.saturatingadd(rhs)), Some(u64::MAX), ); ```

Thanks to the trait OptionSaturatingAdd we can write:

rust assert_eq!( lhs.opt_saturating_add(rhs), Some(u64::MAX), );

The trait can also be used with the inner type:

``` rust asserteq!( lhs.optsaturating_add(u64::MAX), Some(u64::MAX), );

asserteq!( 1.optsaturating_add(rhs), Some(u64::MAX), ); ```

Alternative to PartialOrd for Option<T>

Another purpose is to workaround the PartiaOrd implementation for Option<T>, which uses the declaration order of the variants for Option. None appearing before Some(_), it results in the following behavior:

``` rust let some_0 = Some(0); let none: Option = None;

asserteq!(none.partialcmp(&some0), Some(Ordering::Less)); asserteq!(some0.partialcmp(&none), Some(Ordering::Greater)); ```

In some cases, we might consider that None reflects a value which is not defined and thus can not be compared with Some(_).

rust assert_eq!(none.opt_cmp(&some_0), None); assert_eq!(some_0.opt_cmp(&none), None);

Of course, this is consistent with other usual comparisons:

rust assert_eq!(none.opt_lt(&some_0), None); assert_eq!(none.opt_min(&some_0), None);

LICENSE

This crate is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.