Struct QueryByExample 

pub struct QueryByExample { /* private fields */ }

A validated conjunction of clauses.

Every clause is checked as it is added, so a built query can never carry a vacuous clause and evaluation has nothing left to validate.

Implementations

impl QueryByExample

pub fn new() -> Self

An empty query, which matches every entry.

pub fn push(&mut self, clause: PredicateClause) -> Result<(), PredicateError>

Add one clause.

Errors

Returns PredicateError if the clause would silently match every entry: a zero attribute mask, or an empty name set.

pub fn with(self, clause: PredicateClause) -> Result<Self, PredicateError>

Add one clause, taking and returning the query for chaining.

Errors

As push.

pub fn clauses(&self) -> &[PredicateClause]

The clauses, in the order they were added.

pub fn is_empty(&self) -> bool

Whether this query has no clauses, and so matches every entry.

pub fn matches(&self, entry: &DirectoryEntry) -> bool

Whether entry satisfies every clause.

Short-circuits on the first clause that fails, so an early cheap clause spares the later expensive ones.

Trait Implementations

impl Clone for QueryByExample

fn clone(&self) -> QueryByExample

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryByExample

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

Formats the value using the given formatter.

impl Default for QueryByExample

fn default() -> QueryByExample

Returns the “default value” for a type.

impl Eq for QueryByExample

impl From<QueryByExample> for EntryPredicate

fn from(query: QueryByExample) -> Self

Converts to this type from the input type.

impl PartialEq for QueryByExample

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for QueryByExample