SG::detail::IteratorBase Class Reference

#include <SGIterator.h>

Inheritance diagram for SG::detail::IteratorBase:

Collaboration diagram for SG::detail::IteratorBase:

Public Member Functions
DataProxy *	proxy () const
	The proxy pointed at by this iterator. More...
const std::string &	key () const
	Get the key string with which the current object was stored. More...

Protected Member Functions
	IteratorBase ()
	Default constructor. More...
	IteratorBase (SG::ConstProxyIterator itr, SG::ConstProxyIterator itrEnd, bool isConst)
	Constructor from proxy iterator pair. More...
	IteratorBase (const IteratorBase &other)
	Copy constructor. More...
	~IteratorBase ()
	Destructor. More...
IteratorBase &	operator= (const IteratorBase &other)
	Assignment. More...
StatusCode	setState (SG::ConstProxyIterator itr, SG::ConstProxyIterator itrEnd, bool isConst)
	Reset state of the iterator. More...
void	increment ()
	Move to the next valid proxy. More...
bool	eql (const IteratorBase &rhs) const
	Equality check. More...
void	const_check () const
	Const check: throw an exception if we're pointing at a const proxy. More...

Private Member Functions
void	addRef ()
	Add a reference count to all proxies in our range. More...
void	release ()
	Remove a reference count from all proxies in our range. More...

Private Attributes
std::vector< SG::DataProxy * >	m_proxies
	All proxies in our range, in reverse order. More...

Friends
class	boost::iterator_core_access
class	::SGImplSvc

Detailed Description

Implementation class, not to be used directly Iterates over valid proxies it the range. Maintains a reference count on proxies within the range.

Definition at line 37 of file SGIterator.h.

Constructor & Destructor Documentation

IteratorBase() [1/3]

SG::detail::IteratorBase::IteratorBase ( )

protected

Default constructor.

Definition at line 18 of file SGIterator.cxx.

{
}

IteratorBase() [2/3]

SG::detail::IteratorBase::IteratorBase ( SG::ConstProxyIterator  itr, SG::ConstProxyIterator  itrEnd, bool  isConst  )

explicitprotected

Constructor from proxy iterator pair.

Parameters

itr	Starting proxy iterator.
itrEnd	Ending proxy iterator.
isConst	If false, take only non-const proxies.

Will skip ahead to the first valid proxy.

Definition at line 31 of file SGIterator.cxx.

{
  // Save all valid proxies in reverse order.  Also take out a refcount on each.
  while (itr != itrEnd) {
    --itrEnd;
    DataProxy* dp = itrEnd->second;
    if (dp->isValid() && (isConst || !dp->isConst())) {
      m_proxies.push_back (dp);
      dp->addRef();
    }
  }
}

IteratorBase() [3/3]

SG::detail::IteratorBase::IteratorBase ( const IteratorBase &  other )

protected

Copy constructor.

Definition at line 50 of file SGIterator.cxx.

  : m_proxies (other.m_proxies)
{
  // Maintain shared ownership of elements in our range.
  this->addRef();
}

~IteratorBase()

SG::detail::IteratorBase::~IteratorBase ( )

protected

Destructor.

Definition at line 61 of file SGIterator.cxx.

{
  // Release ownership of everything in our range.
  this->release();
}

Member Function Documentation

addRef()

void SG::detail::IteratorBase::addRef ( )

private

Add a reference count to all proxies in our range.

const_check()

void SG::detail::IteratorBase::const_check ( ) const

protected

Const check: throw an exception if we're pointing at a const proxy.

Called when dereferencing a non-const iterator.

Definition at line 137 of file SGIterator.cxx.

{
  // This should usually not be needed, since we check for constness
  // when initializing the iterator.  However, it is possible for a proxy
  // to be marked as const after the iterator has been formed, so keep the check.
  const SG::DataProxy* dp = this->proxy();
  if (dp->isConst()) {
    const IProxyDict* store = dp->store();
    throw SG::ExcConstObject (dp->clID(),
                              dp->name(),
                              store ? store->name() : "(unknown)");
  }
}

eql()

bool SG::detail::IteratorBase::eql ( const IteratorBase &  rhs ) const

protected

Equality check.

increment()

void SG::detail::IteratorBase::increment ( )

protected

Move to the next valid proxy.

Used by the boost iterator adapter.

Definition at line 123 of file SGIterator.cxx.

{
  if (!m_proxies.empty()) {
    m_proxies.back()->release();
    m_proxies.pop_back();
  }
}

key()

const std::string & SG::detail::IteratorBase::key

(

)

const

Get the key string with which the current object was stored.

Definition at line 155 of file SGIterator.cxx.

{
  return m_proxies.back()->name();
}

operator=()

SG::detail::IteratorBase & SG::detail::IteratorBase::operator= ( const IteratorBase &  other )

protected

Assignment.

Definition at line 72 of file SGIterator.cxx.

{
  if (this != &other) {
    // Assign, maintaining refcounts.
    this->release();
    m_proxies = other.m_proxies;
    this->addRef();
  }
  return *this;
}

proxy()

DataProxy* SG::detail::IteratorBase::proxy

(

)

const

The proxy pointed at by this iterator.

release()

void SG::detail::IteratorBase::release ( )

private

Remove a reference count from all proxies in our range.

setState()

StatusCode SG::detail::IteratorBase::setState ( SG::ConstProxyIterator  itr, SG::ConstProxyIterator  itrEnd, bool  isConst  )

protected

Reset state of the iterator.

Parameters

itr	Starting proxy iterator.
itrEnd	Ending proxy iterator.
isConst	Is this for a const iterator?

Will skip ahead to the first valid proxy. Returns FAILURE if the range is empty.

Definition at line 94 of file SGIterator.cxx.

{
  this->release();
  m_proxies.clear();
 
  while (itr != itrEnd) {
    --itrEnd;
    DataProxy* dp = itrEnd->second;
    if (dp->isValid() && (isConst || !dp->isConst())) {
      m_proxies.push_back (dp);
      dp->addRef();
    }
  }
 
  if (m_proxies.empty()) {
    return StatusCode::FAILURE;
  }
 
  return StatusCode::SUCCESS;
}

Friends And Related Function Documentation

::SGImplSvc

friend class ::SGImplSvc

friend

Definition at line 43 of file SGIterator.h.

boost::iterator_core_access

friend class boost::iterator_core_access

friend

Definition at line 40 of file SGIterator.h.

Member Data Documentation

m_proxies

std::vector<SG::DataProxy*> SG::detail::IteratorBase::m_proxies

private

All proxies in our range, in reverse order.

Definition at line 146 of file SGIterator.h.

---

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

• SGIterator.h
• SGIterator.cxx