Quick Links: |
#include <bdlcc_objectcatalog.h>
Public Member Functions | |
ObjectCatalogIter (const ObjectCatalog< TYPE > &catalog) | |
~ObjectCatalogIter () | |
void | operator++ () |
operator const void * () const | |
bsl::pair< int, TYPE > | operator() () const |
int | handle () const |
const TYPE & | value () const |
Provide thread safe iteration through all the objects of an object catalog of parameterized TYPE
. The order of the iteration is implementation defined. An iterator is valid if it is associated with an object in the catalog, otherwise it is invalid. Thread-safe iteration is provided by (read)locking the object catalog during the iterator's construction and unlocking it at the iterator's destruction. This guarantees that during the life time of an iterator, the object catalog can't be modified (nevertheless, multiple threads can concurrently read the object catalog).
See Component bdlcc_objectcatalog
bdlcc::ObjectCatalogIter< TYPE >::ObjectCatalogIter | ( | const ObjectCatalog< TYPE > & | catalog | ) | [explicit] |
Create an iterator for the specified catalog
and associate it with the first member of the catalog
. If the catalog
is empty then the iterator is initialized to be invalid. The catalog
is locked for read for the duration of iterator's life.
bdlcc::ObjectCatalogIter< TYPE >::~ObjectCatalogIter | ( | ) |
Destroy this iterator and unlock the catalog associated with it.
void bdlcc::ObjectCatalogIter< TYPE >::operator++ | ( | ) |
Advance this iterator to refer to the next object of the associated catalog; if there is no next object in the associated catalog, then this iterator becomes invalid. The behavior is undefined unless this iterator is valid. Note that the order of the iteration is not specified.
bdlcc::ObjectCatalogIter< TYPE >::operator const void * | ( | ) | const |
Return non-zero if the iterator is valid, and 0 otherwise.
bsl::pair<int, TYPE> bdlcc::ObjectCatalogIter< TYPE >::operator() | ( | ) | const |
Return a pair containing the handle (as the first element of the pair) and the object (as the second element of the pair) associated with this iterator. The behavior is undefined unless the iterator is valid.
int bdlcc::ObjectCatalogIter< TYPE >::handle | ( | ) | const |
Return the handle referred to by the iterator. The behavior is undefined unless the iterator is valid.
const TYPE& bdlcc::ObjectCatalogIter< TYPE >::value | ( | ) | const |
Return a const
reference to the value referred to by the iterator. The behavior is undefined unless the iterator is valid.