Struct Row 

pub struct Row { /* private fields */ }

A container for a single row within a query result set.

RowIterator::next() yields a Row.

Each Row contains parsed cell values and a reference to the table schema.

Zero-Copy Struct Mapping via Derive Macros

Define typed structs with #[derive(FromRow)] to convert rows directly into your domain types using TryFrom<Row> without unnecessary allocations:

#[derive(FromRow, Debug)]
struct UserStats {
    name: String,
    count: i64,
}

let user: UserStats = row.try_into()?;
println!("{}: {}", user.name, user.count);

Field Extraction by Name or Index

Retrieve individual cell values by column name (&str) or index (usize) using get(), try_get(), or take():

let name: String = row.get("name");
let age: i64 = row.get(1);
println!("{name} is {age} years old");

Implementations

impl Row

pub fn try_get<T: FromSql, I: ColumnIndex>( &self, index: I, ) -> Result<T, RowError>

Attempts to retrieve a value from the row by column name or zero-based index.

The return type must implement FromSql.

Errors

Returns RowError::ColumnNotFound if the column does not exist, RowError::IndexOutOfRange if the index exceeds schema bounds, or RowError::TypeConversion if the value cannot be converted to T.

Example

let msg: String = row.try_get("msg")?;
println!("Value: {msg}");

pub fn take<T: FromSql, I: ColumnIndex>( &mut self, index: I, ) -> Result<T, RowError>

Takes ownership of a value from the row by column name or zero-based index.

This replaces the cell value in the row with Value::Null in-place to avoid cloning. Attempting to read the column again after calling take() yields Value::Null.

Errors

Returns the same errors as try_get().

Example

let text: String = row.take("big_text")?;
println!("Length: {}", text.len());

pub fn get<T: FromSql, I: ColumnIndex>(&self, index: I) -> T

Retrieves a value from the row by column name or zero-based index.

Panics

Panics if the column does not exist or if the value cannot be converted to type T.

Example

let count: i64 = row.get("count");
println!("Count: {count}");

Trait Implementations

impl Clone for Row

fn clone(&self) -> Row

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Row

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

Formats the value using the given formatter.