Struct Row 

#[non_exhaustive]
pub struct Row { /* private fields */ }

A single row from a query result.

Implementations

impl Row

pub fn len(&self) -> usize

Number of columns in the row.

pub fn is_empty(&self) -> bool

Returns true if the row has no columns.

pub fn columns(&self) -> &[FieldDescription]

Returns the column descriptions.

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

Returns true if the value at index is SQL NULL.

pub fn get_raw(&self, index: usize) -> Option<&[u8]>

Returns the raw bytes for the column at index, or None if NULL.

pub fn get<T: FromSql>(&self, index: usize) -> Result<T>

Decode the column at index as type T.

Type inference

The type T must implement FromSql for the column’s PostgreSQL type OID. If the types don’t match, a TypeConversion error is returned.

NULL handling

If the column value is SQL NULL, this method returns Err(PgError::UnexpectedNull). To handle NULL values, use Option<T> as the type parameter:

let val: Option<i32> = row.get(0)?; // NULL → None

Errors

• PgError::ColumnIndexOutOfBounds — index exceeds column count
• PgError::UnexpectedNull — column is NULL and T is not Option
• PgError::TypeConversion — type mismatch between PG type and T

pub fn get_by_name<T: FromSql>(&self, name: &str) -> Result<T>

Decode a column by name as type T.

Column name lookup is O(n) where n is the number of columns. For performance-critical code, prefer index-based access.

Errors

• PgError::ColumnNotFound — no column with the given name
• PgError::UnexpectedNull — column is NULL and T is not Option
• PgError::TypeConversion — type mismatch between PG type and T

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

Get the name of a column by index.

Returns None if the index is out of bounds.

pub fn column_index(&self, name: &str) -> Option<usize>

Get the index of a column by name.

Column name lookup is O(n) where n is the number of columns. For performance-critical code, prefer index-based access.

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.