Struct FilterExpression 

pub struct FilterExpression { /* private fields */ }

An immutable Boolean expression in a crate::MetadataFilter.

Expressions are constructed by FilterExpressionBuilder and can be inspected without allocation through FilterExpression::view. Their private representation prevents callers from constructing structurally invalid expression trees. The structure is Boolean, while evaluation uses a private three-valued outcome so missing data stays unknown through NOT, AND, and OR.

Examples

use qubit_metadata::FilterExpression;

let expression = FilterExpression::builder()
    .eq("tenant", "acme")
    .build()?;
assert!(matches!(
    expression.view(),
    qubit_metadata::FilterExpressionView::Condition(_)
));

Implementations

impl FilterExpression

pub const fn builder() -> FilterExpressionBuilder

Creates a builder for a non-empty filter expression.

pub const fn match_all() -> Self

Creates an expression that matches every metadata object.

pub const fn match_none() -> Self

Creates an expression that matches no metadata object.

pub fn try_and(self, other: Self) -> MetadataResult<Self>

Combines this expression with other using logical AND.

Parameters

• other - Expression whose conditions must also match.

Errors

Returns MetadataError::FilterLimitExceeded when the resulting expression exceeds library hard limits.

pub fn try_or(self, other: Self) -> MetadataResult<Self>

Combines this expression with other using logical OR.

Parameters

• other - Expression whose conditions may also match.

Errors

Returns MetadataError::FilterLimitExceeded when the resulting expression exceeds library hard limits.

pub fn try_not(self) -> MetadataResult<Self>

Negates this expression.

Errors

Returns MetadataError::FilterLimitExceeded when the resulting expression exceeds library hard limits.

pub fn view(&self) -> FilterExpressionView<'_>

Returns a borrowed view of this expression node.

Returns

A zero-copy view preserving the node’s Boolean structure.

Trait Implementations

impl Clone for FilterExpression

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilterExpression

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

Formats the expression without exposing its cached implementation metrics.

Parameters

• formatter - Formatter that receives the output.

impl PartialEq for FilterExpression

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

Equality operator ==.

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

Inequality operator !=.

impl Redact for FilterExpression

fn write_redacted(&self, writer: &mut RedactionWriter<'_>)

Writes the expression tree through the caller’s cumulative budget.

Parameters

• writer - Destination that receives the encoded or redacted output.

impl StructuralPartialEq for FilterExpression