Struct former::VectorSubformer

pub struct VectorSubformer<E, Container, Context, ContainerEnd>
where
    Container: VectorLike<E> + Default,
    ContainerEnd: ToSuperFormer<Container, Context>,
{ /* private fields */ }

A builder for constructing VectorLike containers, facilitating a fluent and flexible interface.

VectorSubformer leverages the VectorLike trait to enable the construction and manipulation of vector-like containers in a builder pattern style, promoting readability and ease of use.

Example

#[ derive( Debug, PartialEq, former::Former ) ]
pub struct StructWithVec
{
  #[ subformer( former::VectorSubformer ) ]
  vec : Vec< &'static str >,
}

let instance = StructWithVec::former()
.vec()
  .push( "apple" )
  .push( "banana" )
  .end()
.form();

assert_eq!( instance, StructWithVec { vec: vec![ "apple", "banana" ] } );

Implementations

impl<E, Container, Context, ContainerEnd> VectorSubformer<E, Container, Context, ContainerEnd>

where Container: VectorLike<E> + Default, ContainerEnd: ToSuperFormer<Container, Context>,

pub fn new( ) -> VectorSubformer<E, Container, Container, impl ToSuperFormer<Container, Container>>

Initializes a new VectorSubformer instance, starting with an empty container. This function serves as the entry point for the builder pattern.

Returns

A new instance of VectorSubformer with an empty internal container.

pub fn begin( context: Option<Context>, container: Option<Container>, on_end: ContainerEnd ) -> Self

Begins the building process, optionally initializing with a context and container.

pub fn end(self) -> Context

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

pub fn replace(self, vector: Container) -> Self

Replaces the current container with a provided one, allowing for a reset or redirection of the building process.

impl<E, Container, Context, ContainerEnd> VectorSubformer<E, Container, Context, ContainerEnd>

where Container: VectorLike<E> + Default, ContainerEnd: ToSuperFormer<Container, Context>,

pub fn push<E2>(self, e: E2) -> Self

where E2: Into<E>,

Appends an element to the end of the container, expanding the internal collection.

Trait Implementations

impl<E: Debug, Container, Context: Debug, ContainerEnd> Debug for VectorSubformer<E, Container, Context, ContainerEnd>

where Container: VectorLike<E> + Default + Debug, ContainerEnd: ToSuperFormer<Container, Context> + Debug,

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

Formats the value using the given formatter.

impl<E: Default, Container, Context: Default, ContainerEnd> Default for VectorSubformer<E, Container, Context, ContainerEnd>

where Container: VectorLike<E> + Default + Default, ContainerEnd: ToSuperFormer<Container, Context> + Default,

fn default() -> VectorSubformer<E, Container, Context, ContainerEnd>

Returns the “default value” for a type.