Struct spacetimedb_table::table::RowRef

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

A reference to a single row within a table.

Safety

Having a r: RowRef is a proof that r.pointer() refers to a valid row. This makes constructing a RowRef, i.e., RowRef::new, an unsafe operation.

Implementations

impl<'a> RowRef<'a>

pub fn to_product_value(&self) -> ProductValue

Extract a ProductValue from the table.

This is a potentially expensive operation, as it must walk the table’s ProductTypeLayout and heap-allocate various substructures of the ProductValue.

pub fn project_not_empty( self, cols: &ColList ) -> Result<AlgebraicValue, InvalidFieldError>

Construct a projection of the row at self by extracting the cols.

Returns an error if cols specifies an index which is out-of-bounds for the row at self.

If cols contains more than one column, the values of the projected columns are wrapped in a ProductValue. If cols is a single column, the value of that column is returned without wrapping in a ProductValue.

pub fn pointer(&self) -> RowPointer

Returns the raw row pointer for this row reference.

Trait Implementations

impl<'a> Clone for RowRef<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RowRef<'_>

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

Formats the value using the given formatter.

impl Serialize for RowRef<'_>

fn serialize<S: Serializer>(&self, ser: S) -> Result<S::Ok, S::Error>

Serialize self in the data format of S using the provided serializer.

impl<'a> Copy for RowRef<'a>