Struct RowReference 

pub struct RowReference { /* private fields */ }

A lightweight reference to a row in source data

Instead of cloning entire rows during query processing, RowReference stores just enough information to locate the row when materialization is needed.

Memory Comparison

For a row with 10 columns averaging 32 bytes each:

• Full Row: 320+ bytes (plus heap allocations for strings)
• RowReference: 16 bytes (table_id + row_index)

This is 20x more memory efficient for intermediate results.

Example

// Create references instead of copying rows
let refs: Vec<RowReference> = qualifying_indices
    .iter()
    .map(|&idx| RowReference::new(0, idx as u32))
    .collect();

// Only materialize at output boundary
let output_rows: Vec<Row> = refs
    .iter()
    .map(|r| source_tables[r.table_id()].row(r.row_index()))
    .collect();

Implementations

impl RowReference

pub const fn new(table_id: u16, row_index: u32) -> Self

Create a new row reference

pub const fn table_id(&self) -> u16

Get the table identifier

pub const fn row_index(&self) -> u32

Get the row index within the table

pub fn range(table_id: u16, start: u32, end: u32) -> Vec<Self>

Create a vector of row references for a range of rows

pub fn from_selection(table_id: u16, indices: &[u32]) -> Vec<Self>

Create row references from a selection vector

Trait Implementations

impl Clone for RowReference

fn clone(&self) -> RowReference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RowReference

impl Debug for RowReference

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

Formats the value using the given formatter.

impl Eq for RowReference

impl Hash for RowReference

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RowReference

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RowReference