Struct FilteredResult 

pub struct FilteredResult { /* private fields */ }

Filtered result that applies a WHERE clause to an underlying result

This struct owns a pre-compiled RowFilter, avoiding per-row compilation. The filter is compiled once during construction and reused for every row.

Implementations

impl FilteredResult

pub fn new( inner: Box<dyn QueryResult>, filter_expr: &Expression, ) -> Result<Self>

Create a new expression-filtered result

Arguments

• inner - The source result to filter
• filter_expr - The WHERE clause expression

Returns an error if the filter expression cannot be compiled.

pub fn from_filter(inner: Box<dyn QueryResult>, filter: RowFilter) -> Self

Create from a pre-built RowFilter

Use this when you have a RowFilter that was constructed with specific context (e.g., with_context for correlated subqueries).

pub fn with_defaults( inner: Box<dyn QueryResult>, filter_expr: Expression, ) -> Result<Self>

Create with default function registry (static lifetime)

Trait Implementations

impl QueryResult for FilteredResult

fn columns(&self) -> &[String]

Returns the column names in the result

fn next(&mut self) -> bool

Moves the cursor to the next row

fn scan(&self, dest: &mut [Value]) -> Result<()>

Scans the current row into the provided values

fn row(&self) -> &Row

Returns the current row directly without copying

fn take_row(&mut self) -> Row

Takes ownership of the current row (avoids clone)

fn close(&mut self) -> Result<()>

Closes the result set and releases resources

fn rows_affected(&self) -> i64

Returns the number of rows affected by an INSERT, UPDATE, or DELETE

fn last_insert_id(&self) -> i64

Returns the last inserted ID for an INSERT operation

fn last_error(&mut self) -> Option<Error>

Returns a pending error from the last next() call, if any.

fn with_aliases( self: Box<Self>, aliases: FxHashMap<String, String>, ) -> Box<dyn QueryResult>

Sets column aliases for this result

fn columns_arc(&self) -> Option<CompactArc<Vec<String>>>

Returns column names as Arc for zero-copy sharing

fn try_into_arc_rows(&mut self) -> Option<CompactArc<Vec<Row>>>

Try to extract all rows as CompactArc<Vec<Row>> for zero-copy joins

fn estimated_count(&self) -> Option<usize>

Returns an estimate of the total number of rows in the result.

fn supports_typed_batches(&self) -> bool

Whether the result can yield decoded typed column batches without constructing a row/value object for every result record.

fn typed_batch_fallback_reason(&self) -> Option<TypedBatchFallbackReason>

If supports_typed_batches() is false, return the best semantic reason.

fn next_typed_batch(&mut self) -> Result<Option<TypedColumnBatch>, Error>

Advance to the next typed column batch.