// --------------------------------------------------------
// $Id: ChannelIteratorI.h,v 1.1.1.1 2001/01/24 02:52:30 luchini Exp $
//
// Please refer to NOTICE.txt,
// included as part of this distribution,
// for legal information.
//
// Kay-Uwe Kasemir, kasemir@lanl.gov
// --------------------------------------------------------
#ifndef __CHANNELITERATORI_H__
#define __CHANNELITERATORI_H__
#include "ChannelI.h"
//CLASS ChannelIteratorI
// Channel iterator interface to be implemented.
// The preferred API is CLASS ChannelIterator.
class ChannelIteratorI
{
public:
virtual ~ChannelIteratorI ();
//* Does Iterator hold valid channel ?
virtual bool isValid () const = 0;
//* Access to Channel
virtual ChannelI *getChannel () = 0;
//* Move to next channel
virtual bool next () = 0;
};
//CLASS ChannelIterator
// Iterator for looping over channels,
// can be used similar to CLASS ChannelI pointer:
//
Examples
//
//
// (Implemented as "smart pointer" wrapper for CLASS ChannelIteratorI interface)
class ChannelIterator
{
public:
//* Obtain new, empty ChannelIterator suitable for given Archive
ChannelIterator (const class Archive &archive);
ChannelIterator (ChannelIteratorI *iter);
ChannelIterator ();
~ChannelIterator ();
void attach (ChannelIteratorI *iter);
void detach ();
//* Does Iterator hold valid channel ?
operator bool () const;
//* Access to Channel
ChannelI *operator -> ();
ChannelI &operator * ();
//* Move to next channel
ChannelIterator &operator ++ ();
// Direct access to interface
ChannelIteratorI *getI () { return _ptr; }
const ChannelIteratorI *getI () const { return _ptr; }
private:
// Copying is prohibited because it's unclear
// how to copy all the possible implementations
// of a ChannelIteratorI.
// If two ChannelIterators shall reference the same channel,
// the ArchiveI has to be queried for the same channel twice.
ChannelIterator (const ChannelIterator &rhs); // not impl.
ChannelIterator & operator = (const ChannelIterator &rhs); // not impl.
ChannelIteratorI *_ptr;
};
inline ChannelIterator::ChannelIterator (ChannelIteratorI *iter)
{ _ptr = iter; }
inline ChannelIterator::ChannelIterator ()
{ _ptr = 0; }
inline ChannelIterator::~ChannelIterator ()
{
if (_ptr)
{
delete _ptr;
_ptr = 0;
}
}
inline void ChannelIterator::attach (ChannelIteratorI *iter)
{
if (_ptr)
delete _ptr;
_ptr = iter;
}
inline void ChannelIterator::detach ()
{ _ptr = 0; }
inline ChannelIterator::operator bool () const
{ return _ptr->isValid (); }
inline ChannelI *ChannelIterator::operator -> ()
{ return _ptr->getChannel (); }
inline ChannelI &ChannelIterator::operator * ()
{ return *_ptr->getChannel (); }
inline ChannelIterator &ChannelIterator::operator ++ ()
{ _ptr->next (); return *this; }
#endif //__CHANNELITERATORI_H__