IrrlichtEngine
Classes | Public Types | Public Member Functions
irr::core::map< KeyType, ValueType > Class Template Reference

map template for associative arrays using a red-black tree More...

#include <irrMap.h>

List of all members.

Classes

class  AccessClass
class  ConstIterator
 Const Iterator. More...
class  Iterator
 Normal Iterator. More...
class  ParentFirstIterator
 Parent First Iterator. More...
class  ParentLastIterator
 Parent Last Iterator. More...
class  RBTree
 red/black tree for map

Public Types

typedef RBTree< KeyType,
ValueType > 
Node

Public Member Functions

void clear ()
 Clear the entire tree.
Nodedelink (const KeyType &k)
 Removes a node from the tree and returns it.
bool empty () const
Nodefind (const KeyType &keyToFind) const
ConstIterator getConstIterator () const
 Returns a Constiterator.
Iterator getIterator () const
 Returns an iterator.
ParentFirstIterator getParentFirstIterator () const
ParentLastIterator getParentLastIterator () const
NodegetRoot () const
bool insert (const KeyType &keyNew, const ValueType &v)
 Inserts a new node into the tree.
_IRR_DEPRECATED_ bool isEmpty () const
 map ()
AccessClass operator[] (const KeyType &k)
 operator [] for access to elements
bool remove (const KeyType &k)
 Removes a node from the tree and deletes it.
bool remove (Node *p)
 Removes a node from the tree and deletes it.
void set (const KeyType &k, const ValueType &v)
 Replaces the value if the key already exists, otherwise inserts a new element.
u32 size () const
 Returns the number of nodes in the tree.
void swap (map< KeyType, ValueType > &other)
 Swap the content of this map container with the content of another map.
 ~map ()

Detailed Description

template<class KeyType, class ValueType>
class irr::core::map< KeyType, ValueType >

map template for associative arrays using a red-black tree

Definition at line 18 of file irrMap.h.


Member Typedef Documentation

template<class KeyType, class ValueType>
typedef RBTree<KeyType,ValueType> irr::core::map< KeyType, ValueType >::Node

Definition at line 134 of file irrMap.h.


Constructor & Destructor Documentation

template<class KeyType, class ValueType>
irr::core::map< KeyType, ValueType >::map ( ) [inline]

Definition at line 669 of file irrMap.h.

template<class KeyType, class ValueType>
irr::core::map< KeyType, ValueType >::~map ( ) [inline]

Definition at line 672 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::clear().


Member Function Documentation

template<class KeyType, class ValueType>
void irr::core::map< KeyType, ValueType >::clear ( ) [inline]
template<class KeyType, class ValueType>
Node* irr::core::map< KeyType, ValueType >::delink ( const KeyType &  k) [inline]

Removes a node from the tree and returns it.

The returned node must be deleted by the user

Parameters:
kthe key to remove
Returns:
A pointer to the node, or 0 if not found

Definition at line 780 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::find().

template<class KeyType, class ValueType>
bool irr::core::map< KeyType, ValueType >::empty ( ) const [inline]

Is the tree empty?

Returns:
Returns true if empty, false if not

Definition at line 885 of file irrMap.h.

References _IRR_IMPLEMENT_MANAGED_MARSHALLING_BUGFIX.

Referenced by irr::core::map< KeyType, ValueType >::isEmpty().

template<class KeyType, class ValueType>
Node* irr::core::map< KeyType, ValueType >::find ( const KeyType &  keyToFind) const [inline]

Search for a node with the specified key.

Parameters:
keyToFind,:The key to find
Returns:
Returns 0 if node couldn't be found.

Definition at line 900 of file irrMap.h.

Referenced by irr::core::map< KeyType, ValueType >::delink(), irr::core::map< KeyType, ValueType >::AccessClass::operator ValueType(), irr::core::map< KeyType, ValueType >::remove(), and irr::core::map< KeyType, ValueType >::set().

template<class KeyType, class ValueType>
ConstIterator irr::core::map< KeyType, ValueType >::getConstIterator ( ) const [inline]

Returns a Constiterator.

Definition at line 956 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::getRoot().

template<class KeyType, class ValueType>
Iterator irr::core::map< KeyType, ValueType >::getIterator ( ) const [inline]

Returns an iterator.

Definition at line 949 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::getRoot().

template<class KeyType, class ValueType>
ParentFirstIterator irr::core::map< KeyType, ValueType >::getParentFirstIterator ( ) const [inline]

Returns a ParentFirstIterator. Traverses the tree from top to bottom. Typical usage is when storing the tree structure, because when reading it later (and inserting elements) the tree structure will be the same.

Definition at line 967 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::getRoot().

template<class KeyType, class ValueType>
ParentLastIterator irr::core::map< KeyType, ValueType >::getParentLastIterator ( ) const [inline]

Returns a ParentLastIterator to traverse the tree from bottom to top. Typical usage is when deleting all elements in the tree because you must delete the children before you delete their parent.

Definition at line 978 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::getRoot().

Referenced by irr::core::map< KeyType, ValueType >::clear().

template<class KeyType, class ValueType>
Node* irr::core::map< KeyType, ValueType >::getRoot ( ) const [inline]
template<class KeyType, class ValueType>
bool irr::core::map< KeyType, ValueType >::insert ( const KeyType &  keyNew,
const ValueType &  v 
) [inline]

Inserts a new node into the tree.

Parameters:
keyNew,:the index for this value
v,:the value to insert
Returns:
True if successful, false if it fails (already exists)

Definition at line 685 of file irrMap.h.

References _IRR_IMPLEMENT_MANAGED_MARSHALLING_BUGFIX.

Referenced by irr::core::map< KeyType, ValueType >::set().

template<class KeyType, class ValueType>
_IRR_DEPRECATED_ bool irr::core::map< KeyType, ValueType >::isEmpty ( ) const [inline]
Deprecated:
Use empty() instead. This method may be removed by Irrlicht 1.9

Definition at line 892 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::empty().

template<class KeyType, class ValueType>
AccessClass irr::core::map< KeyType, ValueType >::operator[] ( const KeyType &  k) [inline]

operator [] for access to elements

for example myMap["key"]

Definition at line 990 of file irrMap.h.

template<class KeyType, class ValueType>
bool irr::core::map< KeyType, ValueType >::remove ( const KeyType &  k) [inline]

Removes a node from the tree and deletes it.

Returns:
True if the node was found and deleted

Definition at line 819 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::find().

template<class KeyType, class ValueType>
bool irr::core::map< KeyType, ValueType >::remove ( Node p) [inline]

Removes a node from the tree and deletes it.

Returns:
True if the node was found and deleted

Definition at line 827 of file irrMap.h.

References _IRR_IMPLEMENT_MANAGED_MARSHALLING_BUGFIX.

template<class KeyType, class ValueType>
void irr::core::map< KeyType, ValueType >::set ( const KeyType &  k,
const ValueType &  v 
) [inline]

Replaces the value if the key already exists, otherwise inserts a new element.

Parameters:
kThe index for this value
vThe new value of

Definition at line 767 of file irrMap.h.

References irr::core::map< KeyType, ValueType >::find(), and irr::core::map< KeyType, ValueType >::insert().

Referenced by irr::core::map< KeyType, ValueType >::AccessClass::operator=().

template<class KeyType, class ValueType>
u32 irr::core::map< KeyType, ValueType >::size ( ) const [inline]

Returns the number of nodes in the tree.

Definition at line 928 of file irrMap.h.

template<class KeyType, class ValueType>
void irr::core::map< KeyType, ValueType >::swap ( map< KeyType, ValueType > &  other) [inline]

Swap the content of this map container with the content of another map.

Afterwards this object will contain the content of the other object and the other object will contain the content of this object. Iterators will afterwards be valid for the swapped object.

Parameters:
otherSwap content with this object

Definition at line 938 of file irrMap.h.


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