Struct QueryCeiling 

pub struct QueryCeiling {
    pub applied: usize,
    pub offset: usize,
    pub source: CeilingSource,
    pub kind: CeilingKind,
    pub universe_total: Option<usize>,
}

The ceiling one query applied, as the command that applied it saw it.

Fields

applied: usize

Rows the query was allowed to return.

offset: usize

Rows the query skipped before returning any.

A non-zero offset means the page is a recorte even when applied alone would have covered the universe.

source: CeilingSource

Whether the caller chose the value or a constant did.

kind: CeilingKind

Whether the ceiling pages a universe or bounds a ranking.

universe_total: Option<usize>

Size of the universe, when the command can count it.

None is not “unbounded”: it means the command has no universe to compare against, which is exactly why CeilingKind::TopK is never refused.

Implementations

impl QueryCeiling

pub fn truncated_the_universe(&self) -> bool

true when the ceiling actually kept rows out of the envelope.

A --limit wider than the corpus cut nothing, so a predicate over the result observed the whole universe and there is nothing to refuse. This is what keeps list --limit 100000 --filter … working.

Trait Implementations

impl Clone for QueryCeiling

fn clone(&self) -> QueryCeiling

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for QueryCeiling

impl Debug for QueryCeiling

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

Formats the value using the given formatter.