Struct Row

pub struct Row<'a> { /* private fields */ }

A single row in a Realm table. This allows you to either extract Values manually, or use realm_model! to convert them into your own structs.

Implementations

impl<'a> Row<'a>

pub fn entries(&self) -> impl Iterator<Item = (&Cow<'a, str>, &Value)>

Returns an iterator over the column names and values in this row.

pub fn values(&self) -> impl Iterator<Item = &Value>

Returns an iterator over the values in this row.

pub fn get(&self, column_name: &str) -> Option<&Value>

Get the value of a column by its name. Returns None if the column does not exist.

pub fn take(&mut self, column_name: &str) -> Option<Value>

Take the value of a column by its name. Returns None if the column does not exist. This method consumes the value, removing it from the row. It is used by realm_model to transfer the backlinks to your custom struct.

pub fn backlinks(&self) -> impl Iterator<Item = &Backlink>

Returns an iterator over the Backlinks in this row.

pub fn take_backlinks(&mut self) -> Vec<Backlink>

Take the Backlinks in this row. This method consumes the backlinks, removing them from the row. It is used by realm_model to transfer the backlinks to your custom struct.

pub fn has_field(&self, key: &str) -> bool

Check if the row has a field with the given name.

impl Row<'_>

pub fn into_owned(self) -> Row<'static>

Convert this row into an owned row.

By default, when you load a row, the names of the columns are borrowed from the columns in the originating table. This can be inconvenient for lifetime reasons, so this method allows you to sever that connection, by cloning the column names.

Note that this is only necessary if you want to interact with the row manually. If you use realm_model!, the column names are no longer used.

Trait Implementations

impl<'a> Clone for Row<'a>

fn clone(&self) -> Row<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Row<'a>

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

Formats the value using the given formatter.

impl<'a> TryFrom<Row<'a>> for Backlink

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for DateTime<Utc>

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for Link

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for String

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for bool

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for f32

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for f64

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a> TryFrom<Row<'a>> for i64

type Error = ValueError

The type returned in the event of a conversion error.

fn try_from(value: Row<'a>) -> Result<Self, Self::Error>

Performs the conversion.