ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR > Class Template Reference

Defines a map implementation. More...

#include <Map_T.h>

Inheritance diagram for ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >:

[legend]Collaboration diagram for ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >:


Public Types
typedef ACE_Map_Manager_Iterator_Adapter< ACE_Reference_Pair< const KEY, VALUE >, KEY, VALUE >	iterator_impl
typedef ACE_Map_Manager_Reverse_Iterator_Adapter< ACE_Reference_Pair< const KEY, VALUE >, KEY, VALUE >	reverse_iterator_impl
typedef ACE_Map_Manager< KEY, VALUE, ACE_Null_Mutex >	implementation
Public Member Functions
	ACE_Map_Manager_Adapter (ACE_Allocator *alloc=0)
	Initialize with the <ACE_DEFAULT_MAP_SIZE>.
	ACE_Map_Manager_Adapter (size_t size, ACE_Allocator *alloc=0)
virtual	~ACE_Map_Manager_Adapter (void)
	Close down and release dynamically allocated resources.
virtual int	open (size_t length=ACE_DEFAULT_MAP_SIZE, ACE_Allocator *alloc=0)
	Initialize a <Map> with size <length>.
virtual int	close (void)
	Close down a <Map> and release dynamically allocated resources.
virtual int	bind (const KEY &key, const VALUE &value)
virtual int	bind_modify_key (const VALUE &value, KEY &key)
virtual int	create_key (KEY &key)
virtual int	bind_create_key (const VALUE &value, KEY &key)
virtual int	bind_create_key (const VALUE &value)
virtual int	recover_key (const KEY &modified_key, KEY &original_key)
virtual int	rebind (const KEY &key, const VALUE &value)
virtual int	rebind (const KEY &key, const VALUE &value, VALUE &old_value)
virtual int	rebind (const KEY &key, const VALUE &value, KEY &old_key, VALUE &old_value)
virtual int	trybind (const KEY &key, VALUE &value)
virtual int	find (const KEY &key, VALUE &value)
	Locate associated with <key>.
virtual int	find (const KEY &key)
	Is <key> in the map?
virtual int	unbind (const KEY &key)
	Remove <key> from the map.
virtual int	unbind (const KEY &key, VALUE &value)
virtual size_t	current_size (void) const
	Return the current size of the map.
virtual size_t	total_size (void) const
	Return the total size of the map.
virtual void	dump (void) const
	Dump the state of an object.
ACE_Map_Manager< KEY, VALUE, ACE_Null_Mutex > &	impl (void)
	Accessor to implementation object.
KEY_GENERATOR &	key_generator (void)
	Accessor to key generator.
Protected Member Functions
virtual ACE_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > *	begin_impl (void)
	Return forward iterator.
virtual ACE_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > *	end_impl (void)
virtual ACE_Reverse_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > *	rbegin_impl (void)
	Return reverse iterator.
virtual ACE_Reverse_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > *	rend_impl (void)
Protected Attributes
ACE_Map_Manager< KEY, VALUE, ACE_Null_Mutex >	implementation_
	All implementation details are forwarded to this class.
KEY_GENERATOR	key_generator_
	Functor class used for generating key.
Private Member Functions
void	operator= (const ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR > &)
	ACE_Map_Manager_Adapter (const ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR > &)

Detailed Description

template<class KEY, class VALUE, class KEY_GENERATOR>
class ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >

Defines a map implementation.

Implementation to be provided by <ACE_Map_Manager>.

Member Typedef Documentation

template<class KEY, class VALUE, class KEY_GENERATOR>

typedef ACE_Map_Manager<KEY, VALUE, ACE_Null_Mutex> ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::implementation

template<class KEY, class VALUE, class KEY_GENERATOR>

typedef ACE_Map_Manager_Iterator_Adapter<ACE_Reference_Pair<const KEY, VALUE>, KEY, VALUE> ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::iterator_impl

template<class KEY, class VALUE, class KEY_GENERATOR>

typedef ACE_Map_Manager_Reverse_Iterator_Adapter<ACE_Reference_Pair<const KEY, VALUE>, KEY, VALUE> ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::reverse_iterator_impl

Constructor & Destructor Documentation

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::ACE_Map_Manager_Adapter ( ACE_Allocator * alloc = 0 )

Initialize with the <ACE_DEFAULT_MAP_SIZE>.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::ACE_Map_Manager_Adapter ( size_t size,

ACE_Allocator * alloc = 0

)

Initialize with <size> entries. The <size> parameter is ignored by maps for which an initialize size does not make sense.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::~ACE_Map_Manager_Adapter ( void ) [virtual]

Close down and release dynamically allocated resources.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::ACE_Map_Manager_Adapter ( const ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR > & ) [private]

Member Function Documentation

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > * ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::begin_impl ( void ) [protected, virtual]

Return forward iterator.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::bind ( const KEY & key,

const VALUE & value

) [virtual]

Add <key>/
pair to the map. If <key> is already in the map then no changes are made and 1 is returned. Returns 0 on a successful addition. This function fails for maps that do not allow user specified keys. <key> is an "in" parameter.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::bind_create_key ( const VALUE & value ) [virtual]

Add
to the map. The user does not care about the corresponding key produced by the Map. For maps that do not naturally produce keys, the map adapters will use the <KEY_GENERATOR> class to produce a key. However, the users are responsible for not jeopardizing this key production scheme by using user specified keys with keys produced by the key generator.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::bind_create_key ( const VALUE & value,

KEY & key

) [virtual]

Add
to the map, and the corresponding key produced by the Map is returned through <key> which is an "out" parameter. For maps that do not naturally produce keys, the map adapters will use the <KEY_GENERATOR> class to produce a key. However, the users are responsible for not jeopardizing this key production scheme by using user specified keys with keys produced by the key generator.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::bind_modify_key ( const VALUE & value,

KEY & key

) [virtual]

Add <key>/
pair to the map. <key> is an "inout" parameter and maybe modified/extended by the map to add additional information. To recover original key, call the <recover_key> method.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::close ( void ) [virtual]

Close down a <Map> and release dynamically allocated resources.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::create_key ( KEY & key ) [virtual]

Produce a key and return it through <key> which is an "out" parameter. For maps that do not naturally produce keys, the map adapters will use the <KEY_GENERATOR> class to produce a key. However, the users are responsible for not jeopardizing this key production scheme by using user specified keys with keys produced by the key generator.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE size_t ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::current_size ( void ) const [virtual]

Return the current size of the map.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE void ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::dump ( void ) const [virtual]

Dump the state of an object.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > * ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::end_impl ( void ) [protected, virtual]

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::find ( const KEY & key ) [virtual]

Is <key> in the map?

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::find ( const KEY & key,

VALUE & value

) [virtual]

Locate
associated with <key>.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Map_Manager< KEY, VALUE, ACE_Null_Mutex > & ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::impl ( void )

Accessor to implementation object.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE KEY_GENERATOR & ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::key_generator ( void )

Accessor to key generator.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::open ( size_t length = ACE_DEFAULT_MAP_SIZE,

ACE_Allocator * alloc = 0

) [virtual]

Initialize a <Map> with size <length>.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

void ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::operator= ( const ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR > & ) [private]

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Reverse_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > * ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::rbegin_impl ( void ) [protected, virtual]

Return reverse iterator.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::rebind ( const KEY & key,

const VALUE & value,

KEY & old_key,

VALUE & old_value

) [virtual]

Reassociate <key> with
, storing the old key and value into the "out" parameters <old_key> and <old_value>. The function fails if <key> is not in the map for maps that do not allow user specified keys. However, for maps that allow user specified keys, if the key is not in the map, a new <key>/
association is created.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::rebind ( const KEY & key,

const VALUE & value,

VALUE & old_value

) [virtual]

Reassociate <key> with
, storing the old value into the "out" parameter <old_value>. The function fails if <key> is not in the map for maps that do not allow user specified keys. However, for maps that allow user specified keys, if the key is not in the map, a new <key>/
association is created.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::rebind ( const KEY & key,

const VALUE & value

) [virtual]

Reassociate <key> with
. The function fails if <key> is not in the map for maps that do not allow user specified keys. However, for maps that allow user specified keys, if the key is not in the map, a new <key>/
association is created.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::recover_key ( const KEY & modified_key,

KEY & original_key

) [virtual]

Recovers the original key potentially modified by the map during <bind_modify_key>.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE ACE_Reverse_Iterator_Impl< ACE_Reference_Pair< const KEY, VALUE > > * ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::rend_impl ( void ) [protected, virtual]

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE size_t ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::total_size ( void ) const [virtual]

Return the total size of the map.

Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::trybind ( const KEY & key,

VALUE & value

) [virtual]

Associate <key> with
if and only if <key> is not in the map. If <key> is already in the map, then the
parameter is overwritten with the existing value in the map. Returns 0 if a new <key>/
association is created. Returns 1 if an attempt is made to bind an existing entry. This function fails for maps that do not allow user specified keys.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::unbind ( const KEY & key,

VALUE & value

) [virtual]

Remove <key> from the map, and return the
associated with <key>.
Implements ACE_Map< KEY, VALUE >.

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_INLINE int ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::unbind ( const KEY & key ) [virtual]

Remove <key> from the map.

Implements ACE_Map< KEY, VALUE >.

Member Data Documentation

template<class KEY, class VALUE, class KEY_GENERATOR>

ACE_Map_Manager<KEY, VALUE, ACE_Null_Mutex> ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::implementation_ [protected]

All implementation details are forwarded to this class.

template<class KEY, class VALUE, class KEY_GENERATOR>

KEY_GENERATOR ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR >::key_generator_ [protected]

Functor class used for generating key.

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

Generated on Wed Nov 23 15:49:13 2005 for ACE by

1.4.5

ACE_Map_Manager_Adapter< KEY, VALUE, KEY_GENERATOR > Class Template Reference

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes