include/gdb/networkEdgeReversePointIter.h

Go to the documentation of this file.

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

//
// \file networkEdgeReversePointIter.h
// \brief Contains the DtNetworkEdgeReversePointIter class declaration.
//

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

class DtPoint;
class DtString;

// DtNetworkEdgeReversePointIter is a bidirectional iterator over the points 
// representing a DtNetworkEdge, traversing in the REVERSE direction.
// \invariant At all times, this iterator must point to a valid DtNetworkEdge.
class DT_DLL_gdb DtNetworkEdgeReversePointIter : public DtNetworkEdgePointIter
{
public:

   // constructor
   // \param edge The DtNetworkEdge to iterate over
   DtNetworkEdgeReversePointIter(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.
   DtNetworkEdgeReversePointIter(DtNetworkEdge& edge,
                                 bool isEnd);

   // Constructs a reverse point iterator starting at the specified 
   // segment along the edge, which means the current point will be the ending point
   // of the specified segment.  
   // \param edge The DtNetworkEdge to iterate over
   // \param initialPoint The point in the edge to initialize 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.
   DtNetworkEdgeReversePointIter(DtNetworkEdge& edge,
                                 const DtPoint& initialPoint);
   
   // destructor
   virtual ~DtNetworkEdgeReversePointIter();

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

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

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

   bool operator==(const DtNetworkEdgePointIter& other) const;
   bool operator!=(const DtNetworkEdgePointIter& other) const;

   bool operator==(const DtNetworkEdgeReversePointIter& other) const;
   bool operator!=(const DtNetworkEdgeReversePointIter& other) const;

   // \return the DtString "DtNetworkEdgeReversePointIter"
   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::reverse_iterator myReversePointIter;

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


#endif