Struct insomnia::EnumSet

pub struct EnumSet<T> where
    T: EnumSetType,  { /* fields omitted */ }

An efficient set type for enums.

Serialization

The default representation serializes enumsets as an u8, u16, u32, u64, or u128, whichever is the smallest that can contain all bits that are part of the set.

Unknown bits are ignored, and are simply dropped. To override this behavior, you can add a #[enumset(serialize_deny_unknown)] annotation to your enum.

You can add a #[enumset(serialize_repr = "u8")] annotation to your enum to explicitly set the bit width the EnumSet is serialized as. This can be used to avoid breaking changes in certain serialization formats (such as bincode).

In addition, the #[enumset(serialize_as_list)] annotation causes the EnumSet to be instead serialized as a list. This requires your enum type implement [Serialize] and [Deserialize].

Implementations

impl<T> EnumSet<T> where
    T: EnumSetType, 

pub fn new() -> EnumSet<T>

Returns an empty set.

pub fn only(t: T) -> EnumSet<T>

Returns a set containing a single value.

pub fn empty() -> EnumSet<T>

Returns an empty set.

pub fn all() -> EnumSet<T>

Returns a set with all bits set.

pub fn bit_width() -> u8

Total number of bits this enumset uses. Note that the actual amount of space used is rounded up to the next highest integer type (u8, u16, u32, u64, or u128).

This is the same as EnumSet::variant_count except in enums with "sparse" variants. (e.g. enum Foo { A = 10, B = 20 })

pub fn variant_count() -> u8

The number of valid variants in this enumset.

This is the same as EnumSet::bit_width except in enums with "sparse" variants. (e.g. enum Foo { A = 10, B = 20 })

pub fn to_bits(&self) -> u128

Returns the raw bits of this set

pub fn from_bits(bits: u128) -> EnumSet<T>

Constructs a bitset from raw bits.

Panics

If bits not in the enum are set.

pub fn len(&self) -> usize

Returns the number of values in this set.

pub fn is_empty(&self) -> bool

Checks if the set is empty.

pub fn clear(&mut self)

Removes all elements from the set.

pub fn is_disjoint(&self, other: EnumSet<T>) -> bool

Checks if this set shares no elements with another.

pub fn is_superset(&self, other: EnumSet<T>) -> bool

Checks if all elements in another set are in this set.

pub fn is_subset(&self, other: EnumSet<T>) -> bool

Checks if all elements of this set are in another set.

pub fn union(&self, other: EnumSet<T>) -> EnumSet<T>

Returns a set containing the union of all elements in both sets.

pub fn intersection(&self, other: EnumSet<T>) -> EnumSet<T>

Returns a set containing all elements in common with another set.

pub fn difference(&self, other: EnumSet<T>) -> EnumSet<T>

Returns a set with all elements of the other set removed.

pub fn symmetrical_difference(&self, other: EnumSet<T>) -> EnumSet<T>

Returns a set with all elements not contained in both sets.

pub fn complement(&self) -> EnumSet<T>

Returns a set containing all elements not in this set.

pub fn contains(&self, value: T) -> bool

Checks whether this set contains a value.

pub fn insert(&mut self, value: T) -> bool

Adds a value to this set.

pub fn remove(&mut self, value: T) -> bool

Removes a value from this set.

pub fn insert_all(&mut self, other: EnumSet<T>)

Adds all elements in another set to this one.

pub fn remove_all(&mut self, other: EnumSet<T>)

Removes all values in another set from this one.

pub fn iter(&self) -> EnumSetIter<T>

Creates an iterator over the values in this set.

Trait Implementations

impl<T, O> BitAnd<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

type Output = EnumSet<T>

The resulting type after applying the & operator.

fn bitand(self, other: O) -> <EnumSet<T> as BitAnd<O>>::Output

Performs the & operation.

impl<T, O> BitAndAssign<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

fn bitand_assign(&mut self, rhs: O)

Performs the &= operation.

impl<T, O> BitOr<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

type Output = EnumSet<T>

The resulting type after applying the | operator.

fn bitor(self, other: O) -> <EnumSet<T> as BitOr<O>>::Output

Performs the | operation.

impl<T, O> BitOrAssign<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

fn bitor_assign(&mut self, rhs: O)

Performs the |= operation.

impl<T, O> BitXor<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

type Output = EnumSet<T>

The resulting type after applying the ^ operator.

fn bitxor(self, other: O) -> <EnumSet<T> as BitXor<O>>::Output

Performs the ^ operation.

impl<T, O> BitXorAssign<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

fn bitxor_assign(&mut self, rhs: O)

Performs the ^= operation.

impl<T> Clone for EnumSet<T> where
    T: EnumSetType + Clone,
    <T as EnumSetTypePrivate>::Repr: Clone, 

fn clone(&self) -> EnumSet<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T> Copy for EnumSet<T> where
    T: EnumSetType + Copy,
    <T as EnumSetTypePrivate>::Repr: Copy, 

impl<T> Debug for EnumSet<T> where
    T: EnumSetType + Debug, 

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl<T> Default for EnumSet<T> where
    T: EnumSetType, 

fn default() -> EnumSet<T>

Returns an empty set.

impl<T> Eq for EnumSet<T> where
    T: EnumSetType + Eq,
    <T as EnumSetTypePrivate>::Repr: Eq, 

impl<T> Extend<T> for EnumSet<T> where
    T: EnumSetType, 

fn extend<I>(&mut self, iter: I) where
    I: IntoIterator<Item = T>, 

Extends a collection with the contents of an iterator.

impl<T> From<T> for EnumSet<T> where
    T: EnumSetType, 

fn from(t: T) -> EnumSet<T>

Performs the conversion.

impl<T> FromIterator<T> for EnumSet<T> where
    T: EnumSetType, 

fn from_iter<I>(iter: I) -> EnumSet<T> where
    I: IntoIterator<Item = T>, 

Creates a value from an iterator.

impl<T> Hash for EnumSet<T> where
    T: EnumSetType, 

fn hash<H>(&self, state: &mut H) where
    H: Hasher, 

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<T> IntoIterator for EnumSet<T> where
    T: EnumSetType, 

type Item = T

The type of the elements being iterated over.

type IntoIter = EnumSetIter<T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <EnumSet<T> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<T> Not for EnumSet<T> where
    T: EnumSetType, 

type Output = EnumSet<T>

The resulting type after applying the ! operator.

fn not(self) -> <EnumSet<T> as Not>::Output

Performs the unary ! operation.

impl<T> Ord for EnumSet<T> where
    T: EnumSetType, 

fn cmp(&self, other: &EnumSet<T>) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<EnumSet<LockType>> for LockType

fn eq(&self, other: &EnumSet<LockType>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T> PartialEq<EnumSet<T>> for EnumSet<T> where
    T: EnumSetType + PartialEq<T>,
    <T as EnumSetTypePrivate>::Repr: PartialEq<<T as EnumSetTypePrivate>::Repr>, 

fn eq(&self, other: &EnumSet<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &EnumSet<T>) -> bool

This method tests for !=.

impl<T> PartialEq<T> for EnumSet<T> where
    T: EnumSetType, 

fn eq(&self, other: &T) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T> PartialOrd<EnumSet<T>> for EnumSet<T> where
    T: EnumSetType, 

fn partial_cmp(&self, other: &EnumSet<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> StructuralEq for EnumSet<T> where
    T: EnumSetType, 

impl<T> StructuralPartialEq for EnumSet<T> where
    T: EnumSetType, 

impl<T, O> Sub<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

type Output = EnumSet<T>

The resulting type after applying the - operator.

fn sub(self, other: O) -> <EnumSet<T> as Sub<O>>::Output

Performs the - operation.

impl<T, O> SubAssign<O> for EnumSet<T> where
    O: Into<EnumSet<T>>,
    T: EnumSetType, 

fn sub_assign(&mut self, rhs: O)

Performs the -= operation.