Skip to main content

DynamicListVariableSlot

Struct DynamicListVariableSlot 

Source
pub struct DynamicListVariableSlot<S> {
    pub entity: EntityClassId,
    pub variable: VariableId,
    pub entity_type_name: &'static str,
    pub variable_name: &'static str,
    /* private fields */
}
Expand description

Public dynamic list variable slot.

Fields§

§entity: EntityClassId

Logical entity class ID the slot is bound to.

§variable: VariableId

Logical variable ID the slot is bound to.

§entity_type_name: &'static str

Entity type name, checked against the SolutionDescriptor on resolution.

§variable_name: &'static str

Variable name, checked against the SolutionDescriptor on resolution.

Implementations§

Source§

impl<S> DynamicListVariableSlot<S>

Source

pub fn try_with_access( entity: EntityClassId, variable: VariableId, entity_type_name: &'static str, variable_name: &'static str, access: Arc<dyn DynamicListAccess<S>>, ) -> Result<Self, String>

Fallible access constructor for integrations that compile a slot from runtime schema. This verifies that the object supplying mutations is bound to exactly the same logical entity and variable as the slot.

Integrations requiring immutable metadata can use Self::with_access_and_metadata to validate both bindings together.

Source

pub fn with_access_and_metadata( entity: EntityClassId, variable: VariableId, entity_type_name: &'static str, variable_name: &'static str, access: Arc<dyn DynamicListAccess<S>>, metadata: Arc<dyn DynamicListMetadata<S>>, ) -> Result<Self, String>

Constructs a slot with its immutable, structurally bound metadata.

Metadata identity is checked immediately; a binding implementation cannot accidentally be reused for a same-named variable in another entity class. Phase assembly remains responsible for rejecting a selected family whose specific capability bit is absent.

Source

pub fn with_metadata( self, metadata: Arc<dyn DynamicListMetadata<S>>, ) -> Result<Self, String>

Attaches immutable metadata after access construction while preserving the same structural identity validation as Self::with_access_and_metadata.

Source

pub fn resolve_descriptor_index( &mut self, descriptor: &SolutionDescriptor, ) -> Result<(), String>

Resolves this slot’s descriptor and variable indexes against descriptor.

Fails when the logical entity ID, entity type name, logical variable ID, variable name or variable kind do not match the descriptor, or when the slot was pre-bound to a different descriptor index.

Source

pub fn resolved_against( self, descriptor: &SolutionDescriptor, ) -> Result<Self, String>

Consuming form of resolve_descriptor_index.

Source

pub fn is_descriptor_resolved(&self) -> bool

Returns true once both the descriptor index and the variable index are resolved.

Source

pub fn descriptor_index(&self) -> usize

Index of this slot’s entity descriptor in the SolutionDescriptor.

§Panics

Panics if the slot has not been resolved against a SolutionDescriptor.

Source

pub fn descriptor_variable_index(&self) -> usize

Index of this slot’s variable within its entity descriptor.

§Panics

Panics if the slot has not been resolved against a SolutionDescriptor.

Source

pub fn matches_target( &self, entity_class: Option<&str>, variable_name: Option<&str>, ) -> bool

Returns true when this slot matches a configuration target; None for either name matches any entity class or variable.

Source

pub fn entity_count(&self, solution: &S) -> usize

Number of rows of the bound entity class.

Source

pub fn element_count(&self, solution: &S) -> usize

Number of declared elements the list variable distributes.

Source

pub fn element(&self, solution: &S, element_index: usize) -> Option<usize>

Element value at declared source index element_index; None when the element is missing.

Source

pub fn assigned_elements(&self, solution: &S) -> Vec<usize>

Elements currently placed in any row’s list.

Source

pub fn list_len(&self, solution: &S, row: usize) -> usize

Length of one row’s list.

Source

pub fn list_get(&self, solution: &S, row: usize, pos: usize) -> Option<usize>

Element at pos in one row’s list; None when pos is out of range.

Source

pub fn list_insert( &self, solution: &mut S, row: usize, pos: usize, value: usize, )

Inserts value at pos in one row’s list.

Source

pub fn list_remove( &self, solution: &mut S, row: usize, pos: usize, ) -> Option<usize>

Removes and returns the element at pos in one row’s list; None when pos is out of range.

Source

pub fn access_capabilities(&self) -> DynamicListAccessCapabilities

Optional list operations the access binds.

Source

pub fn list_set( &self, solution: &mut S, row: usize, pos: usize, value: usize, ) -> bool

Overwrites the element at pos; returns false when the access does not bind set.

Source

pub fn list_replace( &self, solution: &mut S, row: usize, values: Vec<usize>, ) -> bool

Replaces a complete list row as one logical mutation. Dynamic kernels use this for route replacement rather than composing remove/insert and accidentally publishing multiple dirty/revision transitions.

Source

pub fn list_reverse( &self, solution: &mut S, row: usize, start: usize, end: usize, ) -> bool

Reverses positions start..end of one row’s list; returns false when the access does not bind reverse.

Source

pub fn sublist_remove( &self, solution: &mut S, row: usize, start: usize, end: usize, ) -> Option<Vec<usize>>

Removes and returns positions start..end of one row’s list; None when the access does not bind sublist operations.

Source

pub fn sublist_insert( &self, solution: &mut S, row: usize, pos: usize, values: Vec<usize>, ) -> bool

Inserts values at pos in one row’s list; returns false when the access does not bind sublist operations.

Source

pub fn metadata(&self) -> Option<&dyn DynamicListMetadata<S>>

Returns slot-bound metadata when the integration compiled it.

Absence is intentional and must cause a selected metadata-dependent phase to fail validation; it is never a request to synthesize defaults.

Source

pub fn metadata_capabilities(&self) -> Option<DynamicListMetadataCapabilities>

Capabilities of the attached metadata; None when no metadata is attached.

Source

pub fn require_metadata(&self) -> Result<&dyn DynamicListMetadata<S>, String>

Returns the attached metadata, or an error naming the slot when none is attached.

Source§

impl<S> DynamicListVariableSlot<S>

Source

pub fn new( entity: EntityClassId, variable: VariableId, entity_type_name: &'static str, variable_name: &'static str, ) -> Self

Creates a slot whose access is the model backend itself, without metadata.

Source

pub fn new_with_metadata( entity: EntityClassId, variable: VariableId, entity_type_name: &'static str, variable_name: &'static str, metadata: Arc<dyn DynamicListMetadata<S>>, ) -> Result<Self, String>

Backend-access convenience constructor with immutable metadata.

Trait Implementations§

Source§

impl<S> Clone for DynamicListVariableSlot<S>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<S> Debug for DynamicListVariableSlot<S>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<S> Eq for DynamicListVariableSlot<S>

Source§

impl<S> PartialEq for DynamicListVariableSlot<S>

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.