Enum ActiveBelongsTo 

pub enum ActiveBelongsTo<T>
where
    T: BelongsToCardinality,
{
    NotSet,
    Set(<T as BelongsToCardinality>::Set),
}

State carried by a belongs_to field on an ActiveModelEx. Mirrors the NotSet / Set shape of ActiveValue but for a related model.

Unstable: nested-ActiveModel relation mutation is exempt from semver — the semantics of setting or removing related records may change in a minor (2.x) release.

Variants

NotSet

Field is absent; the related model is left as-is on save.

Set(<T as BelongsToCardinality>::Set)

Set the related ActiveModel on save.

Implementations

impl<T> ActiveBelongsTo<T>

where T: BelongsToCardinality,

pub fn set<M>(model: T::Value<M>) -> Self

where M: Into<<<T as BelongsToCardinality>::Entity as EntityTrait>::ActiveModelEx>,

Construct an ActiveBelongsTo::Set. Accepts a bare active model for a required relation, or an Option<active model> for an optional one.

pub fn take(&mut self) -> Self

Take ownership of this relation state, leaving NotSet in place

pub fn is_not_set(&self) -> bool

Return true if self is NotSet

pub fn is_set(&self) -> bool

Return true if there is a set value

impl<E> ActiveBelongsTo<E>

where E: EntityTrait,

pub fn as_ref(&self) -> Option<&E::ActiveModelEx>

Get a reference, if set

pub fn as_mut(&mut self) -> Option<&mut E::ActiveModelEx>

Get a mutable reference, if set

pub fn is_changed(&self) -> bool

Return true if the containing model is set and changed

pub fn into_option(self) -> Option<E::ActiveModelEx>

Convert into an Option<ActiveModelEx>

pub fn try_into_model(self) -> Result<BelongsTo<E>, DbErr>

where E::ActiveModelEx: TryIntoModel<E::ModelEx>,

Convert this back to a ModelEx container

impl<E> ActiveBelongsTo<Option<E>>

where E: EntityTrait,

pub fn as_ref(&self) -> Option<&E::ActiveModelEx>

Get a reference, if set

pub fn as_mut(&mut self) -> Option<&mut E::ActiveModelEx>

Get a mutable reference, if set

pub fn is_changed(&self) -> bool

Return true if the containing model is set and changed

pub fn into_option(self) -> Option<E::ActiveModelEx>

Convert into an Option<ActiveModelEx>

pub fn try_into_model(self) -> Result<BelongsTo<Option<E>>, DbErr>

where E::ActiveModelEx: TryIntoModel<E::ModelEx>,

Convert this back to a ModelEx container

Trait Implementations

impl<T> Clone for ActiveBelongsTo<T>

where T: BelongsToCardinality, <T as BelongsToCardinality>::Set: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for ActiveBelongsTo<T>

where T: BelongsToCardinality, <T as BelongsToCardinality>::Set: Debug,

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

Formats the value using the given formatter.

impl<T> Default for ActiveBelongsTo<T>

where T: BelongsToCardinality,

fn default() -> ActiveBelongsTo<T>

Returns the “default value” for a type.

impl<T> Eq for ActiveBelongsTo<T>

where T: BelongsToCardinality, <T as BelongsToCardinality>::Set: Eq,

impl<T> PartialEq for ActiveBelongsTo<T>

where T: BelongsToCardinality, <T as BelongsToCardinality>::Set: PartialEq,

fn eq(&self, __other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.