Struct Related 

pub struct Related<C> { /* private fields */ }

Rows loaded for a relationship, grouped by the near side’s key.

Returned by every relation’s load. Look a parent’s related rows up by handing it the parent — the container knows which column to read.

Implementations

impl<C> Related<C>

pub fn empty(near_key: impl Into<String>) -> Related<C>

An empty result — what loading no parents gives you.

pub fn of<N>(&self, near: &N) -> &[C]

where N: Model,

Every related row for near, in the order the query returned them.

pub fn one<N>(&self, near: &N) -> Option<&C>

where N: Model,

The first related row for near — what a has_one or belongs_to wants.

pub fn count_of<N>(&self, near: &N) -> usize

where N: Model,

How many related rows near has among those loaded.

Not the same as Relation::count, which asks the database and is not limited by any limit on the relation.

pub fn is_empty(&self) -> bool

Whether anything was loaded at all.

pub fn len(&self) -> usize

How many rows were loaded, across every parent.

pub fn near_key(&self) -> &str

The column the map is keyed by.

pub fn zip<N>(self, near: Vec<N>) -> Vec<(N, Vec<C>)>

where N: Model,

Pair each of near with its related rows, consuming both.

For handing a controller something to serialise: a Vec<(Post, Vec<Comment>)> rather than two collections and a lookup.

Trait Implementations

impl<C> Clone for Related<C>

where C: Clone,

fn clone(&self) -> Related<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Debug for Related<C>

where C: Debug,

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

Formats the value using the given formatter.