ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID > Class Template Reference

This class is a thin wrapper around ACE_Hash_Map_Manager, which comes handy when ACE_Hash_Map_Manager is to be used with a non-nil ACE_Allocator. This wrapper insures that the appropriate allocator is in place for every operation that accesses or updates the hash map. More...

#include <Hash_Map_With_Allocator_T.h>

Inheritance diagram for ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >:

[legend]

Collaboration diagram for ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >:

[legend]

List of all members.

Public Member Functions
	ACE_Hash_Map_With_Allocator (ACE_Allocator *alloc)
	Constructor.
	ACE_Hash_Map_With_Allocator (size_t size, ACE_Allocator *alloc)
	Constructor that specifies hash table size.
int	bind (const EXT_ID &, const INT_ID &, ACE_Allocator *alloc)
int	unbind (const EXT_ID &, INT_ID &, ACE_Allocator *alloc)
int	unbind (const EXT_ID &, ACE_Allocator *alloc)
int	rebind (const EXT_ID &, const INT_ID &, EXT_ID &, INT_ID &, ACE_Allocator *alloc)
int	find (const EXT_ID &, INT_ID &, ACE_Allocator *alloc)
int	find (const EXT_ID &ext_id, ACE_Allocator *alloc)
	Returns 0 if the ext_id is in the mapping, otherwise -1.
int	close (ACE_Allocator *alloc)

---

Detailed Description

template<class EXT_ID, class INT_ID>
class ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >

This class is a thin wrapper around ACE_Hash_Map_Manager, which comes handy when ACE_Hash_Map_Manager is to be used with a non-nil ACE_Allocator. This wrapper insures that the appropriate allocator is in place for every operation that accesses or updates the hash map.

If we use ACE_Hash_Map_Manager with a shared memory allocator (or memory-mapped file allocator, for example), the allocator pointer used by ACE_Hash_Map_Manager gets stored with it, in shared memory (or memory-mapped file). Naturally, this will cause horrible problems, since only the first process to set that pointer will be guaranteed the address of the allocator is meaningful! That is why we need this wrapper, which insures that appropriate allocator pointer is in place for each call.

At some point it would be a good idea to update this class to use the new "two allocator" technique provided by ACE_Hash_Map_Manager_Ex.

---

Constructor & Destructor Documentation

template<class EXT_ID, class INT_ID>

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::ACE_Hash_Map_With_Allocator

(

ACE_Allocator *

alloc

)

[inline]

Constructor.

template<class EXT_ID, class INT_ID>

ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::ACE_Hash_Map_With_Allocator	(	size_t	size,
		ACE_Allocator *	alloc
	)			[inline]

Constructor that specifies hash table size.

---

Member Function Documentation

template<class EXT_ID, class INT_ID>

ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::bind	(	const EXT_ID &	ext_id,
		const INT_ID &	int_id,
		ACE_Allocator *	alloc
	)			[inline]

template<class EXT_ID, class INT_ID>

ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::unbind	(	const EXT_ID &	ext_id,
		INT_ID &	int_id,
		ACE_Allocator *	alloc
	)			[inline]

template<class EXT_ID, class INT_ID>

ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::unbind	(	const EXT_ID &	ext_id,
		ACE_Allocator *	alloc
	)			[inline]

template<class EXT_ID, class INT_ID>

ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::rebind	(	const EXT_ID &	ext_id,
		const INT_ID &	int_id,
		EXT_ID &	old_ext_id,
		INT_ID &	old_int_id,
		ACE_Allocator *	alloc
	)			[inline]

template<class EXT_ID, class INT_ID>

ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::find	(	const EXT_ID &	ext_id,
		INT_ID &	int_id,
		ACE_Allocator *	alloc
	)			[inline]

template<class EXT_ID, class INT_ID>

ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::find	(	const EXT_ID &	ext_id,
		ACE_Allocator *	alloc
	)			[inline]

Returns 0 if the ext_id is in the mapping, otherwise -1.

template<class EXT_ID, class INT_ID>

ACE_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE int ACE_Hash_Map_With_Allocator< EXT_ID, INT_ID >::close

(

ACE_Allocator *

alloc

)

[inline]

---

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

• Hash_Map_With_Allocator_T.h
• Hash_Map_With_Allocator_T.cpp
• Hash_Map_With_Allocator_T.inl