1 unstable release
0.1.0 | Jun 22, 2023 |
---|
#1722 in Rust patterns
31KB
430 lines
Slots Slice
This is a small crate that aims provides utilities for manipulating slices of optional values, referred to as Slots<T>
.
Features
- Conveniently manipulate slices of optional values.
- Perform operations on slots such as counting, checking emptiness and fullness, and retrieving values and entries.
- Macro syntax for creating and assigning.
Usage
Bring the prelude into scope:
use slots_slice::prelude::*;
The highlight of the crate are SlotsTrait
and SlotsMutTrait
which add methods for accessing and manipulating slots immutably and mutably. These operate on anything that implements AsRef
<[T]
> so they are available right away on structs such as array and Vec<T>
.
Overview of SlotsTrait
:
use slots_slice::prelude::*;
let slots = [None, Some('a'), None, Some('b')];
assert_eq!(slots.count(), 2);
assert!(!slots.is_empty());
assert!(!slots.is_full());
assert_eq!(slots.front_index(true), Some(1));
assert_eq!(slots.front_value(), Some(&'a'));
assert_eq!(slots.front_entry(), Some((1, &'a')));
SlotsMutTrait
provide the mutable version of SlotsTrait
as well as collapse functionality.
use slots_slice::prelude::*;
let mut slots = [None, Some('a'), None, Some('b')];
assert_eq!(slots.front_value_mut(), Some(&mut 'a'));
assert_eq!(slots.front_entry_mut(), Some((1, &mut 'a')));
slots.collapse_front();
assert_eq!(slots, [Some('a'), Some('b'), None, None]);