active::container::MultiMap< Key, T > Class Template Reference

#include <MultiMap.h>

Inheritance diagram for active::container::MultiMap< Key, T >:

Collaboration diagram for active::container::MultiMap< Key, T >:

Public Types
using	base = std::multimap<Key, std::unique_ptr<T>>
	Base container type.
using	raw_type = std::pair<const Key, T>
	Paired key/raw value type.
using	mapped_type = typename base::mapped_type
	Stored type.
using	value_type = typename base::value_type
	Paired key/value type.
using	node_type = typename base::node_type
	Node handle type.
using	size_type = typename base::size_type
	Container size (index) type.
using	iterator = typename base::iterator
	Container iterator type.
using	const_iterator = typename base::const_iterator
	Container const iterator type.

Public Member Functions
	MultiMap ()
	MultiMap (const MultiMap &source)
	MultiMap (MultiMap &&source)
virtual	~MultiMap ()=default
auto	operator= (const MultiMap &source)
auto	operator= (MultiMap &&source)
auto	find (const Key &key) const
auto	insert (const raw_type &item)
auto	insert (const value_type &item)
auto	insert (value_type &&item)
auto	insert (node_type &&node)
auto	emplace (const Key &key, mapped_type &&item)
auto	emplace (const Key &key, T &&item)
auto	release (iterator &pos)
auto	release (const_iterator pos)

Detailed Description

template<class Key, class T>
requires utility::Clonable<T>
class active::container::MultiMap< Key, T >

A specialisation class for a multi-multimap of objects wrapped in unique_ptr paired with a key

This allows multi-multimap to store objects with polymorphic behaviour and object copying (object type must conform to Clonable). Keep in mind that the normal behaviour of the multi-multimap is to take ownership of any objects stored in it (unless release is used)

NB: There is no requirement for container items to be non-null. It is entirely up the implementor if this rule should be adopted or enforced

Constructor & Destructor Documentation

MultiMap() [1/3]

template<class Key , class T >

active::container::MultiMap< Key, T >::MultiMap ( )

inline

Constructor

MultiMap() [2/3]

template<class Key , class T >

active::container::MultiMap< Key, T >::MultiMap ( const MultiMap< Key, T > & source )

inline

Copy constructor

Parameters

source

The object to copy

MultiMap() [3/3]

template<class Key , class T >

active::container::MultiMap< Key, T >::MultiMap ( MultiMap< Key, T > && source )

inline

Move constructor

Parameters

source

The object to move

~MultiMap()

template<class Key , class T >

virtual active::container::MultiMap< Key, T >::~MultiMap ( )

virtualdefault

Destructor

Member Function Documentation

emplace() [1/2]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::emplace ( const Key & key, mapped_type && item )

inline

Emplace a key/value pair into the map

Parameters

item	The key/value pair to insert (already wrapped in unique_ptr)

Here is the caller graph for this function:

emplace() [2/2]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::emplace ( const Key & key, T && item )

inline

Emplace a key/value pair into the map

Parameters

item	The item to push

find()

template<class Key , class T >

auto active::container::MultiMap< Key, T >::find ( const Key & key ) const

inline

Find a value with a specified key

Returns

An iterator pointing to the key/value pair (end() on failure)

insert() [1/4]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::insert ( const raw_type & item )

inline

Insert a key/raw value pair into the map

Parameters

item	The item to push

Returns

A map iterator pointing to the matching/inserted item paired with a bool (true if a new item was inserted)

Here is the call graph for this function:

insert() [2/4]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::insert ( const value_type & item )

inline

Insert a key/value pair into the map

Parameters

item	The item to push

Returns

A map iterator pointing to the matching/inserted item paired with a bool (true if a new item was inserted)

Here is the call graph for this function:

insert() [3/4]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::insert ( node_type && node )

inline

Insert a map node

Parameters

node	The node to insert

Returns

A map iterator pointing to the matching/inserted item paired with a bool (true if a new item was inserted)

insert() [4/4]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::insert ( value_type && item )

inline

Insert a key/object pair into the map

Parameters

item	The item to push

Returns

A map iterator pointing to the matching/inserted item paired with a bool (true if a new item was inserted)

Here is the call graph for this function:

operator=() [1/2]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::operator= ( const MultiMap< Key, T > & source )

inline

Assignment operator

Parameters

source

The object to copy

Returns

A reference to this

operator=() [2/2]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::operator= ( MultiMap< Key, T > && source )

inline

Assignment operator

Parameters

source

The object to move

Returns

A reference to this

release() [1/2]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::release ( const_iterator pos )

inline

Release the pointer held by the specified item and erase

Parameters

pos	An iterator pointing to the item to be removed

Returns

The released pointer from the map item

release() [2/2]

template<class Key , class T >

auto active::container::MultiMap< Key, T >::release ( iterator & pos )

inline

Release the pointer held by the specified item and erase

Parameters

pos	An iterator pointing to the item to be removed

Returns

An iterator at the next value

Here is the call graph for this function:

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• /Users/rwessel/Documents/Development/ActiveLib/Active/Container/MultiMap.h