Struct PhysicalSelection 

pub struct PhysicalSelection { /* private fields */ }

A set of physical row ID ranges, sorted ascending and non-overlapping.

Each range is start..end (exclusive end) in physical row ID space. Consumers convert this to their reader’s row selection type.

Invariants

• Ranges are sorted by start.
• No two ranges overlap or are adjacent (they are merged).
• Each range is non-empty.

Implementations

impl PhysicalSelection

pub fn from_ids(ids: impl IntoIterator<Item = u32>) -> Self

Build from an unsorted iterator of physical row IDs.

Sorts the IDs, deduplicates, and merges into contiguous ranges.

pub fn ranges(&self) -> &[Range<u32>]

The physical ranges (sorted, non-overlapping).

pub fn row_count(&self) -> usize

Total number of selected physical rows.

pub fn is_empty(&self) -> bool

Whether no rows are selected.

pub fn iter_ids(&self) -> impl Iterator<Item = u32> + '_

Iterate over individual physical row IDs in ascending order.

pub fn virtual_order_map(&self, virtual_ids: &[u32]) -> Vec<usize>

Mapping from ascending physical order back to virtual (sorted) order.

Returns a Vec<usize> of length row_count() where result[i] is the 0-based offset within the virtual range that physical row i corresponds to. This is needed to reorder materialised rows back to sort order after a Parquet read (which returns rows in physical order).

Trait Implementations

impl Clone for PhysicalSelection

fn clone(&self) -> PhysicalSelection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PhysicalSelection

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

Formats the value using the given formatter.

impl PartialEq for PhysicalSelection

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PhysicalSelection

impl StructuralPartialEq for PhysicalSelection