networkEdgeSegmentIter.h

Go to the documentation of this file.

/*********************************************************************
** Copyright (c) 2004 MaK Technologies, Inc.
** All rights reserved.
*********************************************************************/
/*********************************************************************
** $RCSfile: networkEdgeSegmentIter.h,v $ $Revision: 1.5 $ $State: Exp $
*********************************************************************/
#ifndef networkEdgeSegmentIter_H_
#define networkEdgeSegmentIter_H_

//
// \file networkEdgeSegmentIter.h
// \brief Contains the DtNetworkEdgeSegmentIter class declaration.
//

#include "gdb/gdbDefines.h"
#include "gdb/networkEdge.h"

class DtSegment;
class DtString;


//
// DtNetworkEdgeSegmentIter is an ABC representing
// an iterator over the segments of a DtNetworkEdge.
// \invariant At all times, this iterator must point to a valid DtNetworkEdge.
class DT_DLL_gdb DtNetworkEdgeSegmentIter 
{
public:
   // \param an edge to iterate over.
   DtNetworkEdgeSegmentIter(DtNetworkEdge& edge);

   // copy constructor
   DtNetworkEdgeSegmentIter(const DtNetworkEdgeSegmentIter& orig);

   // destructor
   virtual ~DtNetworkEdgeSegmentIter();

   // \return A DtPoint representing the starting or ending point of 
   // the segment as defined in the direction of iteration.
   virtual DtPoint startPoint() const = 0;
   virtual DtPoint endPoint() const = 0;

   virtual const DtNetworkEdge& edge() const;

   // Increments/Decrements to the next/previous segment in the edge as defined
   // by the direction of iteration.
   virtual void operator++() = 0; 
   virtual void operator--() = 0; 
   virtual DtNetworkSegment& operator*() const = 0;
   virtual DtNetworkSegment& operator->()  const = 0;

   virtual bool operator==(const DtNetworkEdgeSegmentIter& other) const;
   virtual bool operator!=(const DtNetworkEdgeSegmentIter& other) const;

   // \return The DtString "DtNetworkEdgeSegmentIter"
   virtual const DtString type() const;
   
protected:
   // Tests the invariant of the iterator as defined above.
   // \return a boolean signifying true if the invariant is valid
   // and false otherwise.
   bool testInvariant() const;

   // default constructor
   DtNetworkEdgeSegmentIter();

   DtNetworkEdge* myEdge;
};


inline DtNetworkEdgeSegmentIter::DtNetworkEdgeSegmentIter(DtNetworkEdge& edge):
myEdge(&edge)
{
   assert(testInvariant());
}

inline DtNetworkEdgeSegmentIter::~DtNetworkEdgeSegmentIter()
{
}

inline DtNetworkEdgeSegmentIter::DtNetworkEdgeSegmentIter(const DtNetworkEdgeSegmentIter& orig)
{
   assert(testInvariant());

   myEdge = orig.myEdge;
   
   assert(testInvariant());
}


inline const DtString DtNetworkEdgeSegmentIter::type() const
{
   assert(testInvariant());

   return "DtNetworkEdgeSegmentIter";
}


#endif