networkEdgeForwardPointConstIter.h

Go to the documentation of this file.

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

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

class DtPoint;
class DtString;

// DtNetworkEdgeForwardPointConstIter is a bidirectional const iterator over the points 
// representing a DtNetworkEdge, traversing in the FORWARD direction.
// INVARIANT:  At all times, this iterator must point to a valid DtNetworkEdge.
class DT_DLL_gdb DtNetworkEdgeForwardPointConstIter : public DtNetworkEdgePointConstIter
{
public:

   // constructor
   // \param edge The DtNetworkEdge to iterate over
   DtNetworkEdgeForwardPointConstIter(const DtNetworkEdge& edge);

   // constructor that allows the user to specify that
   // the iterator is initialized to the end of the 
   // points of the edge.
   // \param edge The DtNetworkEdge to iterate over
   // \param isend Is the iterator at the end or not.
   DtNetworkEdgeForwardPointConstIter(const DtNetworkEdge& edge,
                                      bool isEnd);

   // Constructs a forward point iterator starting at the specified 
   // segment along the edge, which means the current point will be the starting point
   // of the specified segment.  
   // \param edge The DtNetworkEdge to iterate over
   // \param initialPoint The point in the edge to intialize to.
   // \note If the initialPoint is NOT in the edge, then the iterator is 
   // initialized to the first point as if no point had been specified.
   DtNetworkEdgeForwardPointConstIter(const DtNetworkEdge& edge,
                                      const DtPoint& initialPoint);

   // destructor
   virtual ~DtNetworkEdgeForwardPointConstIter();

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

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

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

   bool operator==(const DtNetworkEdgePointConstIter& other) const;
   bool operator!=(const DtNetworkEdgePointConstIter& other) const;
   
   bool operator==(const DtNetworkEdgeForwardPointConstIter& other) const;
   bool operator!=(const DtNetworkEdgeForwardPointConstIter& other) const;

   virtual const DtString type() const ;

protected:
   // Used to keep track of where we are in the parent edge since the last segment
   // in either direction will have both a starting and ending point.
   DtNetworkEdge::DtPointContainer::const_iterator myConstPointIter;

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


#endif