Struct CollectionFormer 

pub struct CollectionFormer<E, Definition>
where
    Definition: FormerDefinition,
    Definition::Storage: CollectionAdd<Entry = E>,
{ /* private fields */ }

A builder structure for constructing collections with a fluent and flexible interface.

Implementations

impl<E, Definition> CollectionFormer<E, Definition>

where Definition: FormerDefinition, Definition::Storage: CollectionAdd<Entry = E>,

pub fn begin( storage: Option<Definition::Storage>, context: Option<Definition::Context>, on_end: Definition::End, ) -> Self

Begins the construction process of a collection with optional initial storage and context, setting up an on_end completion handler to finalize the collection’s construction.

Panics

qqq: doc

pub fn begin_coercing<IntoEnd>( storage: Option<Definition::Storage>, context: Option<Definition::Context>, on_end: IntoEnd, ) -> Self

where IntoEnd: Into<Definition::End>,

Provides a variation of the begin method allowing for coercion of the end handler, facilitating ease of integration with different end conditions.

Panics

qqq: docs

pub fn end(self) -> Definition::Formed

Finalizes the building process, returning the formed or a context incorporating it.

Panics

qqq: doc

pub fn form(self) -> Definition::Formed

Alias for the end method to align with typical builder pattern terminologies.

pub fn replace(self, storage: Definition::Storage) -> Self

Replaces the current storage with a provided storage, allowing for resetting or redirection of the building process.

impl<E, Storage, Formed, Definition> CollectionFormer<E, Definition>

where Definition: FormerDefinition<Context = (), Storage = Storage, Formed = Formed>, Definition::Storage: CollectionAdd<Entry = E>,

pub fn new(end: Definition::End) -> Self

Constructs a new CollectionFormer instance, starting with an empty storage. This method serves as the entry point for the builder pattern, facilitating the creation of a new collection.

pub fn new_coercing<IntoEnd>(end: IntoEnd) -> Self

where IntoEnd: Into<Definition::End>,

Variant of the new method allowing for end condition coercion, providing flexibility in specifying different types of end conditions dynamically.

impl<E, Definition> CollectionFormer<E, Definition>

where Definition: FormerDefinition, Definition::Storage: CollectionAdd<Entry = E>,

pub fn add<IntoElement>(self, entry: IntoElement) -> Self

where IntoElement: Into<E>,

Appends an entry to the end of the storage, expanding the internal collection.

Trait Implementations

impl<E, Definition> Debug for CollectionFormer<E, Definition>

where Definition: FormerDefinition, Definition::Storage: CollectionAdd<Entry = E>,

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

Formats the value using the given formatter.

impl<E: Default, Definition> Default for CollectionFormer<E, Definition>

where Definition: FormerDefinition + Default, Definition::Storage: CollectionAdd<Entry = E> + Default, Definition::Context: Default, Definition::End: Default,

fn default() -> CollectionFormer<E, Definition>

Returns the “default value” for a type.

impl<'a, E, Definition> FormerBegin<'a, Definition> for CollectionFormer<E, Definition>

where Definition: FormerDefinition, Definition::Storage: CollectionAdd<Entry = E> + 'a, Definition::Context: 'a, Definition::End: 'a,

fn former_begin( storage: Option<Definition::Storage>, context: Option<Definition::Context>, on_end: Definition::End, ) -> Self

Launches the subforming process with an initial storage and context, setting up an on_end completion handler.