Enum Match 

pub enum Match<T> {
    Specific(T),
    All,
}

Represents matching either a specific value or all values of a given type.

This is used in the Pckn type to support matching multiple kinds of notes at once.

Variants

Specific(T)

Matches a specific value.

All

Matches all values.

Implementations

impl<T> Match<T>

pub const fn as_specific(&self) -> Option<&T>

Returns a reference to the specific value of this matcher, or None if this is Match::All.

Example

use clack_common::events::Match;

assert_eq!(Match::Specific(42).as_specific(), Some(&42));
assert_eq!(Match::<u16>::All.as_specific(), None);

pub fn into_specific(self) -> Option<T>

Returns a reference to the specific value of this matcher, or None if this is Match::All.

Example

use clack_common::events::Match;

assert_eq!(Match::Specific(42).into_specific(), Some(42));
assert_eq!(Match::<u16>::All.into_specific(), None);

pub const fn is_all(&self) -> bool

Returns whether this matcher is Match::All.

Example

use clack_common::events::Match;

assert!(Match::<u16>::All.is_all());
assert!(!Match::Specific(42).is_all());

pub const fn is_specific(&self) -> bool

Returns whether this matcher is Match::Specific.

Example

use clack_common::events::Match;

assert!(Match::Specific(42).is_specific());
assert!(!Match::<u16>::All.is_specific());

impl<T> Match<T>

where T: PartialEq,

pub fn matches(&self, other: impl Into<Match<T>>) -> bool

Returns true if the given Match matches this one, false otherwise.

This will always return true if any of the two is Match::All. Otherwise, if both values are specific, they are compared directly (using their PartialEq implementation).

Example

use clack_common::events::Match;

assert!(Match::Specific(42).matches(42));
assert!(!Match::Specific(42).matches(21));

assert!(Match::Specific(42).matches(Match::All));
assert!(Match::All.matches(42));
assert!(Match::<u16>::All.matches(Match::All));

impl Match<u16>

pub const fn from_raw(raw: i16) -> Match<u16>

Creates the Match that corresponds to the given raw C-FFI compatible i16 type.

pub const fn to_raw(&self) -> i16

Returns the raw C-FFI compatible i16 type that corresponds to this Match.

If this matches a specific value, it is returned. Otherwise, if this matches all values, it returns -1.

impl Match<u32>

pub const fn from_raw(raw: i32) -> Match<u32>

Creates the Match that corresponds to the given raw C-FFI compatible i32 type.

pub const fn to_raw(&self) -> i32

Returns the raw C-FFI compatible i32 type that corresponds to this Match.

If this matches a specific value, it is returned. Otherwise, if this matches all values, it returns -1.

Trait Implementations

impl<T> Clone for Match<T>

where T: Clone,

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Copy for Match<T>

where T: Copy,

impl<T> Debug for Match<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<T> Eq for Match<T>

where T: Eq,

impl From<ClapId> for Match<u32>

fn from(value: ClapId) -> Match<u32>

Converts to this type from the input type.

impl<T> From<T> for Match<T>

fn from(value: T) -> Match<T>

Converts to this type from the input type.

impl From<u8> for Match<u16>

fn from(value: u8) -> Match<u16>

Converts to this type from the input type.

impl From<u8> for Match<u32>

fn from(value: u8) -> Match<u32>

Converts to this type from the input type.

impl From<u16> for Match<u32>

fn from(value: u16) -> Match<u32>

Converts to this type from the input type.

impl<T> Hash for Match<T>

where T: Hash,

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T> PartialEq for Match<T>

where T: PartialEq,

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T> StructuralPartialEq for Match<T>

where T: PartialEq,