Struct StatePredicate 

#[non_exhaustive]
pub struct StatePredicate { /* private fields */ }

A block or tag filter, with unspecified properties left as wildcards. An unknown or missing property on a tag member never matches.

Implementations

impl StatePredicate

pub fn block( metadata: &dyn BlockMetadata, block: BlockKey, constraints: &[StateConstraint], ) -> Result<StatePredicate, BlockStateError>

A block filter; unknown properties, illegal values and duplicate properties refuse. A partial filter need not produce the default state’s complete combination.

pub fn tag( metadata: &dyn BlockMetadata, _tags: &dyn Tags, tag: TagKey, constraints: &[StateConstraint], ) -> Result<StatePredicate, BlockStateError>

A tag filter; duplicate properties refuse, but arbitrary properties and empty tags remain valid. Membership is evaluated against authoritative tags at application, not frozen here.

pub fn block_key(&self) -> Option<BlockKey>

The exact block this predicate selects, if it is not a tag filter.

pub fn tag_key(&self) -> Option<TagKey>

The tag this predicate selects, if it is not an exact block filter.

pub fn constraints(&self) -> &[StateConstraint]

Explicit property requirements; all must match, but omitted properties are unrestricted.

Trait Implementations

impl Clone for StatePredicate

fn clone(&self) -> StatePredicate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StatePredicate

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

Formats the value using the given formatter.

impl PartialEq for StatePredicate

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for StatePredicate

impl Wire for StatePredicate

const MIN: usize

Minimum encoded size, used to reject impossible collection lengths.

fn put(&self, out: &mut Writer)

Encodes this value, recording failures on the writer.

fn put_owned(self, out: &mut Writer)

Consumes owned data when a resource’s ownership must cross the boundary.

fn take(input: &mut Reader<'_>) -> Result<StatePredicate, WireError>

Decodes one value, leaving any following bytes for the caller.