Enum MatcherKey 

#[non_exhaustive]
pub enum MatcherKey {
    TrackAlias,
    GroupId,
    SubgroupId,
    ObjectId,
    Priority,
    EveryNth,
}

One value key a Matcher can be built on.

Six variants, spelled as the Matcher fields are, so a refusal names something an author can search their own configuration for — the same contract ShapeError::InertMatcher’s key field carries, and deliberately the same spelling, so the two rejections read alike.

Two Matcher fields are not here, and their absence is a decision rather than an omission:

• Matcher::side is the forwarding task’s own direction label, not a field any unit carries, so no draft can fail to carry it. The one side value that names nothing a hook site sees is already rejected by ShapeProfile::try_new.
• Matcher::stream_kind names which units a rule claims rather than a field those units carry. It is supports_matcher’s second argument, not one of its answers.

Distinct from MatcherField, which is the run’s vocabulary and covers a different set: that enum names the four keys a live session can report absent on a unit it actually saw, this one names the six keys a configuration can be built on before any session exists. They overlap on three names and neither is a superset of the other.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

TrackAlias

Matcher::track_alias.

GroupId

Matcher::group_id.

SubgroupId

Matcher::subgroup_id.

ObjectId

Matcher::object_id.

Priority

Matcher::priority, MoQT’s publisher_priority.

EveryNth

Matcher::every_nth.

Implementations

impl MatcherKey

pub const ALL: [MatcherKey; 6]

Every key, in the order the fields are declared on Matcher.

Published so a caller can sweep the whole axis without transcribing it; Capabilities::admit_class reports in this order too.

pub const fn field_name(self) -> &'static str

The key’s name as the Matcher field is spelled.

Trait Implementations

impl Clone for MatcherKey

fn clone(&self) -> MatcherKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MatcherKey

impl Debug for MatcherKey

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

Formats the value using the given formatter.

impl Eq for MatcherKey

impl Hash for MatcherKey

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

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 PartialEq for MatcherKey

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MatcherKey