Trait Row

pub trait Row:
    Unpin
    + Send
    + Sync
    + 'static {
    type Database: Database<Row = Self>;

    // Required methods
    fn columns(&self) -> &[<Self::Database as Database>::Column];
    fn try_get_raw<I>(
        &self,
        index: I,
    ) -> Result<<Self::Database as Database>::ValueRef<'_>, Error>
       where I: ColumnIndex<Self>;

    // Provided methods
    fn is_empty(&self) -> bool { ... }
    fn len(&self) -> usize { ... }
    fn column<I>(&self, index: I) -> &<Self::Database as Database>::Column
       where I: ColumnIndex<Self> { ... }
    fn try_column<I>(
        &self,
        index: I,
    ) -> Result<&<Self::Database as Database>::Column, Error>
       where I: ColumnIndex<Self> { ... }
    fn get<'r, T, I>(&'r self, index: I) -> T
       where I: ColumnIndex<Self>,
             T: Decode<'r, Self::Database> + Type<Self::Database> { ... }
    fn get_unchecked<'r, T, I>(&'r self, index: I) -> T
       where I: ColumnIndex<Self>,
             T: Decode<'r, Self::Database> { ... }
    fn try_get<'r, T, I>(&'r self, index: I) -> Result<T, Error>
       where I: ColumnIndex<Self>,
             T: Decode<'r, Self::Database> + Type<Self::Database> { ... }
    fn try_get_unchecked<'r, T, I>(&'r self, index: I) -> Result<T, Error>
       where I: ColumnIndex<Self>,
             T: Decode<'r, Self::Database> { ... }
}

Represents a single row from the database.

Required Associated Types

type Database: Database<Row = Self>

Required Methods

fn columns(&self) -> &[<Self::Database as Database>::Column]

Gets all columns in this statement.

fn try_get_raw<I>( &self, index: I, ) -> Result<<Self::Database as Database>::ValueRef<'_>, Error>

where I: ColumnIndex<Self>,

Index into the database row and decode a single value.

Errors

• ColumnNotFound if the column by the given name was not found.
• ColumnIndexOutOfBounds if the usize index was greater than the number of columns in the row.

Provided Methods

fn is_empty(&self) -> bool

Returns true if this row has no columns.

fn len(&self) -> usize

Returns the number of columns in this row.

fn column<I>(&self, index: I) -> &<Self::Database as Database>::Column

where I: ColumnIndex<Self>,

Gets the column information at index.

A string index can be used to access a column by name and a usize index can be used to access a column by position.

Panics

Panics if index is out of bounds. See try_column for a non-panicking version.

fn try_column<I>( &self, index: I, ) -> Result<&<Self::Database as Database>::Column, Error>

where I: ColumnIndex<Self>,

Gets the column information at index or a ColumnIndexOutOfBounds error if out of bounds.

fn get<'r, T, I>(&'r self, index: I) -> T

where I: ColumnIndex<Self>, T: Decode<'r, Self::Database> + Type<Self::Database>,

Index into the database row and decode a single value.

A string index can be used to access a column by name and a usize index can be used to access a column by position.

Panics

Panics if the column does not exist or its value cannot be decoded into the requested type. See try_get for a non-panicking version.

fn get_unchecked<'r, T, I>(&'r self, index: I) -> T

where I: ColumnIndex<Self>, T: Decode<'r, Self::Database>,

Index into the database row and decode a single value.

Unlike get, this method does not check that the type being returned from the database is compatible with the Rust type and blindly tries to decode the value.

Panics

Panics if the column does not exist or its value cannot be decoded into the requested type. See try_get_unchecked for a non-panicking version.

fn try_get<'r, T, I>(&'r self, index: I) -> Result<T, Error>

where I: ColumnIndex<Self>, T: Decode<'r, Self::Database> + Type<Self::Database>,

Index into the database row and decode a single value.

A string index can be used to access a column by name and a usize index can be used to access a column by position.

Errors

• ColumnNotFound if the column by the given name was not found.
• ColumnIndexOutOfBounds if the usize index was greater than the number of columns in the row.
• ColumnDecode if the value could not be decoded into the requested type.

fn try_get_unchecked<'r, T, I>(&'r self, index: I) -> Result<T, Error>

where I: ColumnIndex<Self>, T: Decode<'r, Self::Database>,

Index into the database row and decode a single value.

Unlike try_get, this method does not check that the type being returned from the database is compatible with the Rust type and blindly tries to decode the value.

Errors

• ColumnNotFound if the column by the given name was not found.
• ColumnIndexOutOfBounds if the usize index was greater than the number of columns in the row.
• ColumnDecode if the value could not be decoded into the requested type.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl Row for AnyRow

type Database = Any