Struct former::HashMapSubformer

pub struct HashMapSubformer<K, E, Container, Context, End>
where
    K: Eq + Hash,
    Container: HashMapLike<K, E> + Default,
    End: ToSuperFormer<Container, Context>,
{ /* private fields */ }

A builder for constructing hash map-like structures with a fluent interface.

HashMapSubformer leverages the HashMapLike trait to enable a flexible and customizable way to build hash map-like structures. It supports the chaining of insert operations and allows for the definition of custom end actions to finalize the building process.

Type Parameters

• K: Key type, must implement Eq and Hash.
• E: Element (value) type.
• Container: The hash map-like container being built.
• Context: Type of the optional context used during the building process.
• End: End-of-forming action to be executed upon completion.

Examples

#[ derive( Debug, PartialEq, former::Former ) ]
pub struct StructWithMap
{
  #[ subformer( former::HashMapSubformer ) ]
  map : std::collections::HashMap< &'static str, &'static str >,
}

let struct1 = StructWithMap::former()
.map()
  .insert( "a", "b" )
  .insert( "c", "d" )
  .end()
.form()
;
assert_eq!( struct1, StructWithMap { map : hmap!{ "a" => "b", "c" => "d" } } );

Implementations

impl<K, E, Container, Context, End> HashMapSubformer<K, E, Container, Context, End>

where K: Eq + Hash, Container: HashMapLike<K, E> + Default, End: ToSuperFormer<Container, Context>,

pub fn form(self) -> Container

Form current former into target structure.

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

Create a new instance without context or on end processing. It just returns continaer on end of forming.

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

Make a new HashMapSubformer. It should be called by a context generated for your structure. The context is returned after completion of forming by function `on_end``.

pub fn end(self) -> Context

Return context of your struct moving container there. Should be called after configuring the container.

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

Set the whole container instead of setting each element individually.

impl<K, E, Container, Context, End> HashMapSubformer<K, E, Container, Context, End>

where K: Eq + Hash, Container: HashMapLike<K, E> + Default, End: ToSuperFormer<Container, Context>,

pub fn insert<K2, E2>(self, k: K2, e: E2) -> Self

where K2: Into<K>, E2: Into<E>,

Inserts a key-value pair into the container. If the container doesn’t exist, it is created.

Parameters

• k: The key for the value to be inserted. Will be converted into the container’s key type.
• e: The value to be inserted. Will be converted into the container’s value type.

Returns

Returns self for chaining further insertions or operations.

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

where K2: Into<K>, E2: Into<E>,

Alias for insert.

Parameters

• k: The key for the value to be inserted. Will be converted into the container’s key type.
• e: The value to be inserted. Will be converted into the container’s value type.

Returns

Returns self for chaining further insertions or operations.

Trait Implementations

impl<K, E: Debug, Container, Context: Debug, End> Debug for HashMapSubformer<K, E, Container, Context, End>

where K: Eq + Hash + Debug, Container: HashMapLike<K, E> + Default + Debug, End: ToSuperFormer<Container, Context> + Debug,

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

Formats the value using the given formatter.

impl<K, E: Default, Container, Context: Default, End> Default for HashMapSubformer<K, E, Container, Context, End>

where K: Eq + Hash + Default, Container: HashMapLike<K, E> + Default + Default, End: ToSuperFormer<Container, Context> + Default,

fn default() -> HashMapSubformer<K, E, Container, Context, End>

Returns the “default value” for a type.