Struct Composition 

pub struct Composition { /* private fields */ }

The one composition of descriptor-material providers: every provider that participates, named once.

Structurally non-empty — a composition with no provider is not a composition, it is silence — and duplicate-free by construction.

Implementations

impl Composition

pub const fn of_one(provider: Provider) -> Self

One complete composition from its sole provider.

pub fn declared(providers: Vec<Provider>) -> Result<Self, CompositionError>

Declare the complete provider set.

The ordinary caller supplies its natural Vec; this guard turns it into the private non-empty bounded representation before any duplicate work begins. Duplicates are refused rather than deduplicated: silently keeping one of two entries is how a composition stops matching the providers that exist.

Errors

Returns CompositionError carrying DeclarationError::Absent where no provider was supplied, DeclarationError::Unbounded where the provider set outgrows PROVIDER_LIMIT, then every provider identity declared more than once after the roster is admitted.

pub fn first(&self) -> &Provider

The first declared provider; structurally there is one.

pub fn providers(&self) -> &NonEmpty<Provider, PROVIDER_LIMIT>

Every declared provider; structurally at least one.

The set is keyed by provider identity, so nothing identity-bearing is derived from this order.

Trait Implementations

impl Clone for Composition

fn clone(&self) -> Composition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Composition

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

Formats the value using the given formatter.

impl Eq for Composition

impl Hash for Composition

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 Composition

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Composition