Struct DuckRow 

pub struct DuckRow(/* private fields */);

A single row from a DuckDB query result. A single row of data returned by a DuckDB query, consisting of typed values and their associated column names.

Values are accessible by column index via get_idx or by column name via get.

Column names are shared via Arc across every row of the same result set: cloning a DuckRow (as the iterator does internally when rewind support is enabled) is one Arc bump, not a fresh per-row allocation of every column name.

Implementations

impl DuckRow

pub fn new(result: Vec<DuckValue>, col_names: Arc<[Box<str>]>) -> DuckRow

Creates a new DuckRow from a vector of values and a shared, owned slice of column names.

Arguments

• result - The column values for this row.
• col_names - Owned column names, one per value, shared across the result set.

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

Returns a reference to the value for the given column name, or None if no column with that name exists in this row.

The comparison is case-sensitive and matches by string value (not by pointer).

Arguments

• name - The column name to look up.

pub fn get_idx(&self, idx: usize) -> Option<&DuckValue>

Returns a reference to the value at the given column index, or None if the index is out of range.

Arguments

• idx - Zero-based column index.

pub fn column_count(&self) -> u64

Returns the number of columns in this row.

pub fn from_chunk( chunk: &mut DataChunk, col_names: Arc<[Box<str>]>, col_types: &[DUCKDB_TYPE], ) -> Result<Self>

Constructs a DuckRow from the current position of a DataChunk.

Errors

Returns an error if the chunk has no columns or if a column vector is null.

Trait Implementations

impl Clone for DuckRow

fn clone(&self) -> DuckRow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DuckRow

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

Formats the value using the given formatter.