Struct Row 

pub struct Row { /* private fields */ }

A row from a query result, providing typed value access.

This type abstracts over the underlying transport (TCP or gRPC), providing a consistent API for accessing column values regardless of how the data was retrieved.

Example

for row in result.rows() {
    let row = row?;
    let id: Option<i32> = row.get(0);
    let name: Option<String> = row.get(1);
    // Or use direct accessors
    let value = row.get_f64(2);
}

Implementations

impl Row

pub fn schema(&self) -> Option<&ResultSchema>

Returns the schema this row belongs to, if attached.

Every row produced by Rowset::next_chunk has a schema attached — so this returns Some for any row obtained through the public API.

pub fn sql_type(&self, idx: usize) -> Option<SqlType>

Returns the SqlType of the column at the given index, if the schema is attached and the index is in bounds.

Useful for metadata-dependent decoders like Self::get_numeric that need per-column precision and scale. Most callers reach for Self::get / Self::try_get instead, which handle this lookup internally via the RowValue trait.

pub fn get<T: RowValue>(&self, idx: usize) -> Option<T>

Gets a typed value at the given column index.

Example

let id: Option<i32> = row.get(0);
let name: Option<String> = row.get(1);

pub fn try_get<T: RowValue>(&self, idx: usize, column_name: &str) -> Result<T>

Gets a typed value at the given column index, returning a Result with a descriptive error on failure.

Use this in FromRow implementations for better error messages than bare row.get(idx).ok_or(...).

Example

impl FromRow for User {
    fn from_row(row: &Row) -> Result<Self> {
        Ok(User {
            id: row.try_get::<i32>(0, "id")?,
            name: row.try_get::<String>(1, "name")?,
        })
    }
}

Errors

• Returns crate::Error::Other if idx is out of bounds for the row’s column count.
• Returns crate::Error::Other if the cell is SQL NULL or its value cannot be decoded as T.

pub fn get_i16(&self, idx: usize) -> Option<i16>

Gets an i16 value at the given column index.

pub fn get_i32(&self, idx: usize) -> Option<i32>

Gets an i32 value at the given column index.

pub fn get_i64(&self, idx: usize) -> Option<i64>

Gets an i64 value at the given column index.

pub fn get_f32(&self, idx: usize) -> Option<f32>

Gets an f32 value at the given column index.

pub fn get_f64(&self, idx: usize) -> Option<f64>

Gets an f64 value at the given column index.

pub fn get_bool(&self, idx: usize) -> Option<bool>

Gets a bool value at the given column index.

pub fn get_string(&self, idx: usize) -> Option<String>

Gets a String value at the given column index.

pub fn is_null(&self, idx: usize) -> bool

Checks if the value at the given column is null.

pub fn column_count(&self) -> usize

Returns the number of columns in this row.

pub fn get_bytes(&self, idx: usize) -> Option<Vec<u8>>

Gets raw bytes at the given column index.

For TCP rows, returns the raw binary data. For Arrow rows, this method is not available and returns None.

pub fn get_date(&self, idx: usize) -> Option<Date>

Gets a Date value at the given column index.

pub fn get_time(&self, idx: usize) -> Option<Time>

Gets a Time value at the given column index.

pub fn get_timestamp(&self, idx: usize) -> Option<Timestamp>

Gets a Timestamp value at the given column index.

pub fn get_offset_timestamp(&self, idx: usize) -> Option<OffsetTimestamp>

Gets an OffsetTimestamp (TIMESTAMP WITH TIME ZONE) value at the given column index.

pub fn get_interval(&self, idx: usize) -> Option<Interval>

Gets an Interval value at the given column index.

pub fn get_numeric(&self, idx: usize) -> Option<Numeric>

Gets a NUMERIC value at the given column index.

This is the metadata-aware variant of Self::get_bytes + hyperdb_api_core::types::Numeric::from_binary_with_scale: it looks up the column’s SqlType::Numeric { scale, .. } from the attached schema and decodes the wire bytes with that scale, handling both of Hyper’s NUMERIC wire forms transparently:

• 8 bytes (i64) when the column’s declared precision ≤ 18 (Hyper’s Type::Numeric). This is what aggregates like AVG(INTEGER) return as Numeric(16, 6).
• 16 bytes (i128) when declared precision > 18 (Hyper’s Type::BigNumeric).

Returns None if any of the following are true: the value is NULL, the schema isn’t attached (which never happens for rows obtained through Rowset::next_chunk), the column at idx isn’t NUMERIC, or the bytes can’t be decoded.

For non-TCP (Arrow/gRPC) rows, this path falls back to reading the Arrow-native Decimal128 / Decimal256 columns; the scale lives in the Arrow type descriptor in that case.

Trait Implementations

impl Debug for Row

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

Formats the value using the given formatter.