include/gdb/networkEdgeForwardSegmentConstIter.h

Go to the documentation of this file.

/*********************************************************************
** Copyright (c) 2004 MAK Technologies, Inc.
** All rights reserved.
*********************************************************************/
/*********************************************************************
** $RCSfile: networkEdgeForwardSegmentConstIter.h,v $ $Revision: 1.4 $ $State: Exp $
*********************************************************************/
#ifndef networkEdgeForwardSegmentConstIter_H_
#define networkEdgeForwardSegmentConstIter_H_

#include "gdb/gdbDefines.h"
#include "gdb/netwrkEdge.h"
#include "gdb/networkEdgeSegmentConstIter.h"

class DtNetworkSegment;
class DtString;

//
// DtNetworkEdgeForwardSegmentConstIter is a bidirectional const iterator over the segments
// representing a DtNetworkEdge, traversing in the FORWARD direction, 
// where forward is defined as the direction the segments comprise the edge in memory.
// INVARIANT:  At all times, this iterator must point to a *valid* DtNetworkEdge.
class DT_DLL_gdb DtNetworkEdgeForwardSegmentConstIter : public DtNetworkEdgeSegmentConstIter
{
public:
   // constructor
   // \param edge The DtNetworkEdge to iterate over
   DtNetworkEdgeForwardSegmentConstIter(const DtNetworkEdge& edge);

   // Constructs a forward segment iterator starting at the specified 
   // segment along the edge
   // \param edge The DtNetworkEdge to iterate over
   // \param segmentIter A segmentIter associated with the specified edge to initialize to.
   DtNetworkEdgeForwardSegmentConstIter(const DtNetworkEdge& edge,
      const DtNetworkEdge::DtSegmentConstIter& segmentConstIter);

   // destructor
   virtual ~DtNetworkEdgeForwardSegmentConstIter();

   // assignment operator
   DtNetworkEdgeForwardSegmentConstIter& operator=(const DtNetworkEdgeForwardSegmentConstIter& orig);

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

   // \return The start or end points of the current segment as defined by the direction
   // of traversal. (i.e., this is a forward segment iter, so the actual segments start point
   // will also be returned as the start point, etc.)
   DtPoint startPoint() const;
   DtPoint endPoint() const;

   void operator++(); 
   void operator--(); 
   const DtNetworkSegment& operator*() const; 
   const DtNetworkSegment& operator->() const;

   bool operator==(const DtNetworkEdgeSegmentConstIter& other) const;
   bool operator==(const DtNetworkEdgeForwardSegmentConstIter& other) const;

   bool operator!=(const DtNetworkEdgeSegmentConstIter& other) const;
   bool operator!=(const DtNetworkEdgeForwardSegmentConstIter& other) const;

   virtual const DtString type() const;

protected:
   DtNetworkEdge::DtSegmentConstIter mySegmentConstIter;

private:
   // default constructor
   DtNetworkEdgeForwardSegmentConstIter();
};


#endif