Struct QueryTerm 

pub struct QueryTerm<R, T: Target> { /* private fields */ }

One query of an order space: the scheme’s query, labelled with the target it was made under, as an OrderTerm is.

Under a marker from target the label is a zero-sized type, so a query of one target, or of one null policy, cannot meet a term of another in OrderSpace::compare_query: that does not compile. Under an OrderTarget the label is stored, and a query and a term of different targets or policies compare as None instead of as noise.

A query is not a term: it has its own type, so it cannot be compared where a term is expected, and the compiler refuses space.compare(&query, &term). Its bytes are bytes, though, as a term’s are: as_bytes and AsRef<[u8]> are there so a caller can send the query to wherever the terms are, and nothing stops a caller writing them into a term’s place. Under block ORE a query has no right half, so every later compare against those bytes returns None; under a scheme whose Query is its Term the mistake is invisible.

== compares the bytes. Whether that is equality of the values searched for depends on the scheme: under block ORE, whose queries are deterministic, it is. A query is for the comparison at hand and should not be persisted or logged, as OrderQuery explains, so Debug shows the target and masks the query.

Implementations

impl<R, T: Target> QueryTerm<R, T>

pub fn target(&self) -> OrderTarget

The target the query was made under.

pub fn null_order(&self) -> Option<NullOrder>

Where the space the query was made in places nulls, or None for a space that gives them no term.

pub fn raw(&self) -> &R

The scheme’s own query.

pub fn into_raw(self) -> R

The scheme’s own query, unlabelled.

impl<R: AsRef<[u8]>, T: Target> QueryTerm<R, T>

pub fn as_bytes(&self) -> &[u8]

The query’s bytes: the scheme’s query’s.

Trait Implementations

impl<R: AsRef<[u8]>, T: Target> AsRef<[u8]> for QueryTerm<R, T>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<R: Clone, T: Clone + Target> Clone for QueryTerm<R, T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R, T> Debug for QueryTerm<R, T>

where T: Debug + Target,

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

Formats the value using the given formatter.

impl<R: Eq, T: Eq + Target> Eq for QueryTerm<R, T>

impl<R, T: Target> OpaqueDebug for QueryTerm<R, T>

impl<R: PartialEq, T: PartialEq + Target> PartialEq for QueryTerm<R, T>

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

Equality operator ==.

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

Inequality operator !=.

impl<R: PartialEq, T: PartialEq + Target> StructuralPartialEq for QueryTerm<R, T>