enumset 1.1.12

A library for creating compact sets of enums.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

#![allow(missing_docs)]

mod array;
mod primitive;

use core::fmt::Debug;
use core::hash::Hash;
use core::ops::*;

/// A trait marking valid underlying bitset storage types and providing the
/// operations `EnumSet` and related types use.
///
/// # Safety
///
/// Note that `iter` *MUST* be implemented correctly and only return bits that
/// are actually set in the representation, or else it will cause undefined
/// behavior upstream in `EnumSet`.
pub trait EnumSetTypeRepr :
    // Basic traits used to derive traits
    Copy +
    Ord +
    Eq +
    Debug +
    Hash +
    Send +
    Sync +
    // Operations used by enumset
    BitAnd<Output = Self> +
    BitOr<Output = Self> +
    BitXor<Output = Self> +
    Not<Output = Self> +
{
    const PREFERRED_ARRAY_LEN: usize;
    const WIDTH: u32;
    const EMPTY: Self;

    fn is_empty(&self) -> bool;

    fn add_bit(&mut self, bit: u32);
    fn remove_bit(&mut self, bit: u32);
    fn has_bit(&self, bit: u32) -> bool;

    fn count_ones(&self) -> u32;

    fn and_not(&self, other: Self) -> Self;

    type Iter: Iterator<Item = u32> + DoubleEndedIterator + Clone + Debug;
    fn iter(self) -> Self::Iter;

    fn from_u8(v: u8) -> Self;
    fn from_u16(v: u16) -> Self;
    fn from_u32(v: u32) -> Self;
    fn from_u64(v: u64) -> Self;
    fn from_u128(v: u128) -> Self;
    fn from_usize(v: usize) -> Self;

    fn to_u8(&self) -> u8;
    fn to_u16(&self) -> u16;
    fn to_u32(&self) -> u32;
    fn to_u64(&self) -> u64;
    fn to_u128(&self) -> u128;
    fn to_usize(&self) -> usize;

    fn try_from_u8(v: u8) -> Option<Self>;
    fn try_from_u16(v: u16) -> Option<Self>;
    fn try_from_u32(v: u32) -> Option<Self>;
    fn try_from_u64(v: u64) -> Option<Self>;
    fn try_from_u128(v: u128) -> Option<Self>;
    fn try_from_usize(v: usize) -> Option<Self>;

    fn try_to_u8(&self) -> Option<u8>;
    fn try_to_u16(&self) -> Option<u16>;
    fn try_to_u32(&self) -> Option<u32>;
    fn try_to_u64(&self) -> Option<u64>;
    fn try_to_u128(&self) -> Option<u128>;
    fn try_to_usize(&self) -> Option<usize>;

    fn to_u64_array<const O: usize>(&self) -> [u64; O];
    fn try_to_u64_array<const O: usize>(&self) -> Option<[u64; O]>;

    fn from_u64_array<const O: usize>(v: [u64; O]) -> Self;
    fn try_from_u64_array<const O: usize>(v: [u64; O]) -> Option<Self>;

    fn to_u64_slice(&self, out: &mut [u64]);
    #[must_use]
    fn try_to_u64_slice(&self, out: &mut [u64]) -> Option<()>;

    fn from_u64_slice(v: &[u64]) -> Self;
    fn try_from_u64_slice(v: &[u64]) -> Option<Self>;
}

pub use array::ArrayRepr;