alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle Class Reference

Description:

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>
class alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle

A value of this type is returned by the methods Extract, which allow removing an element from the hashtable, without deleting its allocated storage and destructing its custom value.

This handle allows writing access to the value of an extracted element. In combination with methods Insert(ElementHandle&) and InsertIfNotExistent(ElementHandle&), this supports changing parts of the element value, including the key-portion with proper re-insertion.

Objects of this type cannot be copied, but just moved.

Definition at line 532 of file hashtable.hpp.

#include <hashtable.hpp>

Collaboration diagram for alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle:

Public Method Index:
	ElementHandle ()
	Default constructor creating and empty handle.
	ElementHandle (ElementHandle &&other)
	ElementHandle (ElementHandle &other)=delete
	Deleted copy constructor.
	~ElementHandle ()
bool	IsEmpty () const
KeyType &	Key () const
MappedType &	Mapped () const
ElementHandle &	operator= (const ElementHandle &other)=delete
	Deleted copy assignment operator.
ElementHandle &	operator= (ElementHandle &&other)
StoredType &	Value () const

Private Field Index:
Element *	element
	The extracted element.
HashTable *	table
	The table we belong to.

Private Method Index:
	ElementHandle (HashTable *pTable, Element *pElement)

Field Details:

element

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

Element* alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::element

private

The extracted element.

Definition at line 539 of file hashtable.hpp.

table

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

HashTable* alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::table

private

The table we belong to.

Definition at line 538 of file hashtable.hpp.

Constructor(s) / Destructor Details:

ElementHandle() [1/3]

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::ElementHandle ( HashTable * pTable, Element * pElement )

inlineprivate

Constructor setting fields table and element.

Parameters

pTable	The table we belong to.
pElement	The extracted element.

Definition at line 544 of file hashtable.hpp.

Here is the call graph for this function:

ElementHandle() [2/3]

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::ElementHandle ( ElementHandle && other )

inline

Move constructor setting the moved object to emtpy.

Parameters

other

The handle to move.

Definition at line 551 of file hashtable.hpp.

Here is the call graph for this function:

ElementHandle() [3/3]

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::ElementHandle ( )

inline

Default constructor creating and empty handle.

Definition at line 556 of file hashtable.hpp.

~ElementHandle()

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::~ElementHandle ( )

inline

Destructor. If this handle is not empty, the allocated storage of the represented element is added to the list of recyclable objects.

Definition at line 580 of file hashtable.hpp.

Method Details:

IsEmpty()

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

bool alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::IsEmpty ( ) const

inline

Determines if this is a "valid" handle.

Returns

Returns true if this objects represents a valid element, false otherwise.

Definition at line 585 of file hashtable.hpp.

Key()

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

KeyType & alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::Key ( ) const

inline

Returns a mutable reference to the key-portion of this element's data. Must not be invoked on empty instances.

Returns

Returns a mutable reference to the key-portion of the represented element.

Definition at line 596 of file hashtable.hpp.

Mapped()

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

MappedType & alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::Mapped ( ) const

inline

Returns a mutable reference to the mapped-portion of this element's data. Must not be invoked on empty instances.

Returns

Returns a mutable reference to the mapped object.

Definition at line 601 of file hashtable.hpp.

operator=()

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

ElementHandle & alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::operator= ( ElementHandle && other )

inline

Move assignment. Disposes any current content, and moves other into this.

Parameters

other

The handle to move into this object.

Returns

A reference to this.

Definition at line 568 of file hashtable.hpp.

Here is the call graph for this function:

Value()

template<typename TAllocator, typename TValueDescriptor, typename THash = std::hash <typename TValueDescriptor::KeyType>, typename TEqual = std::equal_to<typename TValueDescriptor::KeyType>, lang::Caching THashCaching = lang::Caching::Auto, Recycling TRecycling = Recycling::Private>

StoredType & alib::containers::HashTable< TAllocator, TValueDescriptor, THash, TEqual, THashCaching, TRecycling >::ElementHandle::Value ( ) const

inline

Returns a mutable reference to this element's data. Must not be invoked on empty instances.

Returns

Returns a mutable reference to value of the represented element.

Definition at line 590 of file hashtable.hpp.

---

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

• hashtable.hpp