Struct Row 

pub struct Row { /* private fields */ }

A database row with hybrid access patterns.

Stores columns as ordered (Arc<str>, Value) pairs, preserving duplicates. Column names are Arc<str> so that decoders can build them once per statement and share them across every row of a result set (an Arc clone instead of a fresh heap String per cell). Small rows use a linear scan to avoid index-allocation overhead; wider rows lazily build a compact name-to-index map on first get() call.

Duplicate Column Policy

If multiple columns have the same name, get(name) returns the first occurrence.

Implementations

impl Row

pub fn new(columns: Vec<(String, Value)>) -> Self

Create a new row from column-value pairs.

pub fn with_capacity(capacity: usize) -> Self

Create an empty row with enough capacity for the expected column count.

pub fn push_column(&mut self, name: impl Into<Arc<str>>, value: Value)

Append a column while constructing or reshaping a row.

Accepts anything convertible into Arc<str>: decoders pass shared Arc<str> clones (no allocation), reshaping code can keep passing Strings. This invalidates the lazy name index so subsequent lookups stay correct.

pub fn get_by_pos(&self, idx: usize) -> Option<&Value>

Get a value by column position (0-indexed).

pub fn get(&self, name: &str) -> Option<&Value>

Get a value by column name.

Narrow rows use a direct scan. Wider rows lazily build an index on the first lookup. If duplicate columns exist, returns the first occurrence.

pub fn column_name(&self, idx: usize) -> Option<&str>

Get the column name at the given position.

pub fn iter(&self) -> impl Iterator<Item = (&str, &Value)>

Iterate over all columns as (name, value) pairs.

pub fn len(&self) -> usize

Return the number of columns.

pub fn is_empty(&self) -> bool

Check if the row has no columns.

pub fn columns(&self) -> &[(Arc<str>, Value)]

Get all columns as a slice.

pub fn into_columns_iter(self) -> impl Iterator<Item = (Arc<str>, Value)>

Consume the row and iterate over owned (name, value) pairs without forcing the internal storage back into a Vec.

pub fn into_columns(self) -> Vec<(Arc<str>, Value)>

Consume the row and return the owned columns.

Trait Implementations

impl Debug for Row

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

Formats the value using the given formatter.

impl<'row> RowAccess<'row> for Row

Implement RowAccess trait for the owned Row type.

This allows Row to be used with the GAT-based executor interface while maintaining backward compatibility with existing code.

fn get(&'row self, name: &str) -> Option<&'row Value>

Get a value by column name.

fn get_by_pos(&'row self, idx: usize) -> Option<&'row Value>

Get a value by column position (0-indexed).

fn column_name(&'row self, idx: usize) -> Option<&'row str>

Get the column name at the given position.

fn len(&self) -> usize

Returns the number of columns in the row.

fn is_empty(&self) -> bool

Returns true if the row contains no columns.