RhodeCode

    void erase(const Arc& arc) {

      int n = arc.id;

      if(arcs[n].next_in!=-1) {

        arcs[arcs[n].next_in].prev_in = arcs[n].prev_in;

      }

      if(arcs[n].prev_in!=-1) {

        arcs[arcs[n].prev_in].next_in = arcs[n].next_in;

      } else {

        nodes[arcs[n].target].first_in = arcs[n].next_in;

      }

      if(arcs[n].next_out!=-1) {

        arcs[arcs[n].next_out].prev_out = arcs[n].prev_out;

      }

      if(arcs[n].prev_out!=-1) {

        arcs[arcs[n].prev_out].next_out = arcs[n].next_out;

      } else {

        nodes[arcs[n].source].first_out = arcs[n].next_out;

      }

      arcs[n].next_in = first_free_arc;

      first_free_arc = n;

      arcs[n].prev_in = -2;

    }

    void clear() {

      arcs.clear();

      nodes.clear();

      first_node = first_free_node = first_free_arc = -1;

    }

  protected:

    void changeTarget(Arc e, Node n)

    {

      if(arcs[e.id].next_in != -1)

        arcs[arcs[e.id].next_in].prev_in = arcs[e.id].prev_in;

      if(arcs[e.id].prev_in != -1)

        arcs[arcs[e.id].prev_in].next_in = arcs[e.id].next_in;

      else nodes[arcs[e.id].target].first_in = arcs[e.id].next_in;

      if (nodes[n.id].first_in != -1) {

        arcs[nodes[n.id].first_in].prev_in = e.id;

      }

      arcs[e.id].target = n.id;

      arcs[e.id].prev_in = -1;

      arcs[e.id].next_in = nodes[n.id].first_in;

      nodes[n.id].first_in = e.id;

    }

    void changeSource(Arc e, Node n)

    {

      if(arcs[e.id].next_out != -1)

        arcs[arcs[e.id].next_out].prev_out = arcs[e.id].prev_out;

      if(arcs[e.id].prev_out != -1)

        arcs[arcs[e.id].prev_out].next_out = arcs[e.id].next_out;

      else nodes[arcs[e.id].source].first_out = arcs[e.id].next_out;

      if (nodes[n.id].first_out != -1) {

        arcs[nodes[n.id].first_out].prev_out = e.id;

      }

      arcs[e.id].source = n.id;

      arcs[e.id].prev_out = -1;

      arcs[e.id].next_out = nodes[n.id].first_out;

      nodes[n.id].first_out = e.id;

    }

  };

  typedef DigraphExtender<ListDigraphBase> ExtendedListDigraphBase;

  /// \addtogroup graphs

  /// @{

  ///A general directed graph structure.

  ///\ref ListDigraph is a simple and fast <em>directed graph</em>

  ///implementation based on static linked lists that are stored in

  ///\c std::vector structures.

  ///

  ///It conforms to the \ref concepts::Digraph "Digraph concept" and it

  ///also provides several useful additional functionalities.

  ///Most of the member functions and nested classes are documented

  ///only in the concept class.

  ///

  ///An important extra feature of this digraph implementation is that

  ///its maps are real \ref concepts::ReferenceMap "reference map"s.

  ///

  ///\sa concepts::Digraph

  class ListDigraph : public ExtendedListDigraphBase {

  private:

    ///ListDigraph is \e not copy constructible. Use copyDigraph() instead.

    ///ListDigraph is \e not copy constructible. Use copyDigraph() instead.

    ///

    ListDigraph(const ListDigraph &) :ExtendedListDigraphBase() {};

    ///\brief Assignment of ListDigraph to another one is \e not allowed.

    ///Use copyDigraph() instead.

    ///Assignment of ListDigraph to another one is \e not allowed.

    ///Use copyDigraph() instead.

    void operator=(const ListDigraph &) {}

  public:

    typedef ExtendedListDigraphBase Parent;

    /// Constructor

    /// Constructor.

    ///

    ListDigraph() {}

    ///Add a new node to the digraph.

    ///Add a new node to the digraph.

    ///\return the new node.

    Node addNode() { return Parent::addNode(); }

    ///Add a new arc to the digraph.

    ///Add a new arc to the digraph with source node \c s

    ///and target node \c t.

    ///\return the new arc.

    Arc addArc(const Node& s, const Node& t) {

      return Parent::addArc(s, t);

    }

    /// Node validity check

    /// This function gives back true if the given node is valid,

    /// ie. it is a real node of the graph.

    ///

    /// \warning A Node pointing to a removed item

    /// could become valid again later if new nodes are

    /// added to the graph.

    bool valid(Node n) const { return Parent::valid(n); }

    /// Arc validity check

    /// This function gives back true if the given arc is valid,

    /// ie. it is a real arc of the graph.

    ///

    /// \warning An Arc pointing to a removed item

    /// could become valid again later if new nodes are

    /// added to the graph.

    bool valid(Arc a) const { return Parent::valid(a); }

    /// Change the target of \c e to \c n

    /// Change the target of \c e to \c n

    ///

    ///\note The <tt>ArcIt</tt>s and <tt>OutArcIt</tt>s referencing

    ///the changed arc remain valid. However <tt>InArcIt</tt>s are

    ///invalidated.

    ///

    ///\warning This functionality cannot be used together with the Snapshot

    ///feature.

    void changeTarget(Arc e, Node n) {

      Parent::changeTarget(e,n);

    }

    /// Change the source of \c e to \c n

    /// Change the source of \c e to \c n

    ///

    ///\note The <tt>ArcIt</tt>s and <tt>InArcIt</tt>s referencing

    ///the changed arc remain valid. However <tt>OutArcIt</tt>s are

    ///invalidated.

    ///

    ///\warning This functionality cannot be used together with the Snapshot

    ///feature.

    void changeSource(Arc e, Node n) {

      Parent::changeSource(e,n);

    }

    /// Invert the direction of an arc.

    ///\note The <tt>ArcIt</tt>s referencing the changed arc remain

    ///valid. However <tt>OutArcIt</tt>s and <tt>InArcIt</tt>s are

    ///invalidated.

    ///

    ///\warning This functionality cannot be used together with the Snapshot

    ///feature.

    void reverseArc(Arc e) {

      Node t=target(e);

      changeTarget(e,source(e));

      changeSource(e,t);

    }

    /// Reserve memory for nodes.

    /// Using this function it is possible to avoid the superfluous memory

    /// allocation: if you know that the digraph you want to build will

    /// be very large (e.g. it will contain millions of nodes and/or arcs)

    /// then it is worth reserving space for this amount before starting

    /// to build the digraph.

    /// \sa reserveArc

    void reserveNode(int n) { nodes.reserve(n); };

    /// Reserve memory for arcs.

    /// Using this function it is possible to avoid the superfluous memory

    /// allocation: if you know that the digraph you want to build will

    /// be very large (e.g. it will contain millions of nodes and/or arcs)

    /// then it is worth reserving space for this amount before starting

    /// to build the digraph.

    /// \sa reserveNode

    void reserveArc(int m) { arcs.reserve(m); };

    ///Contract two nodes.

    ///This function contracts two nodes.

    ///Node \p b will be removed but instead of deleting

    ///incident arcs, they will be joined to \p a.

    ///The last parameter \p r controls whether to remove loops. \c true

    ///means that loops will be removed.

    ///

    ///\note The <tt>ArcIt</tt>s referencing a moved arc remain

    ///valid. However <tt>InArcIt</tt>s and <tt>OutArcIt</tt>s

    ///may be invalidated.

    ///

    ///\warning This functionality cannot be used together with the Snapshot

    ///feature.

    void contract(Node a, Node b, bool r = true)

    {

      for(OutArcIt e(*this,b);e!=INVALID;) {

        OutArcIt f=e;

        ++f;

        if(r && target(e)==a) erase(e);

        else changeSource(e,a);

        e=f;

      }

      for(InArcIt e(*this,b);e!=INVALID;) {

        InArcIt f=e;

        ++f;

        if(r && source(e)==a) erase(e);

        else changeTarget(e,a);

        e=f;

      }

      erase(b);

    }

    ///Split a node.

    ///This function splits a node. First a new node is added to the digraph,

    ///then the source of each outgoing arc of \c n is moved to this new node.

    ///If \c connect is \c true (this is the default value), then a new arc

    ///from \c n to the newly created node is also added.

    ///\return The newly created node.

    ///

    ///\note The <tt>ArcIt</tt>s referencing a moved arc remain

    ///valid. However <tt>InArcIt</tt>s and <tt>OutArcIt</tt>s may

    ///be invalidated.

    ///

    ///\warning This functionality cannot be used together with the

    ///Snapshot feature.

      }

      if (arcs[n | 1].prev_out != -1) {

        arcs[arcs[n | 1].prev_out].next_out = arcs[n | 1].next_out;

      } else {

        nodes[arcs[n].target].first_out = arcs[n | 1].next_out;

      }

      arcs[n].next_out = first_free_arc;

      first_free_arc = n;

      arcs[n].prev_out = -2;

      arcs[n | 1].prev_out = -2;

    }

    void clear() {

      arcs.clear();

      nodes.clear();

      first_node = first_free_node = first_free_arc = -1;

    }

  protected:

    void changeTarget(Edge e, Node n) {

      if(arcs[2 * e.id].next_out != -1) {

        arcs[arcs[2 * e.id].next_out].prev_out = arcs[2 * e.id].prev_out;

      }

      if(arcs[2 * e.id].prev_out != -1) {

        arcs[arcs[2 * e.id].prev_out].next_out =

          arcs[2 * e.id].next_out;

      } else {

        nodes[arcs[(2 * e.id) | 1].target].first_out =

          arcs[2 * e.id].next_out;

      }

      if (nodes[n.id].first_out != -1) {

        arcs[nodes[n.id].first_out].prev_out = 2 * e.id;

      }

      arcs[(2 * e.id) | 1].target = n.id;

      arcs[2 * e.id].prev_out = -1;

      arcs[2 * e.id].next_out = nodes[n.id].first_out;

      nodes[n.id].first_out = 2 * e.id;

    }

    void changeSource(Edge e, Node n) {

      if(arcs[(2 * e.id) | 1].next_out != -1) {

        arcs[arcs[(2 * e.id) | 1].next_out].prev_out =

          arcs[(2 * e.id) | 1].prev_out;

      }

      if(arcs[(2 * e.id) | 1].prev_out != -1) {

        arcs[arcs[(2 * e.id) | 1].prev_out].next_out =

          arcs[(2 * e.id) | 1].next_out;

      } else {

        nodes[arcs[2 * e.id].target].first_out =

          arcs[(2 * e.id) | 1].next_out;

      }

      if (nodes[n.id].first_out != -1) {

        arcs[nodes[n.id].first_out].prev_out = ((2 * e.id) | 1);

      }

      arcs[2 * e.id].target = n.id;

      arcs[(2 * e.id) | 1].prev_out = -1;

      arcs[(2 * e.id) | 1].next_out = nodes[n.id].first_out;

      nodes[n.id].first_out = ((2 * e.id) | 1);

    }

  };

  typedef GraphExtender<ListGraphBase> ExtendedListGraphBase;

  /// \addtogroup graphs

  /// @{

  ///A general undirected graph structure.

  ///\ref ListGraph is a simple and fast <em>undirected graph</em>

  ///implementation based on static linked lists that are stored in

  ///\c std::vector structures.

  ///

  ///It conforms to the \ref concepts::Graph "Graph concept" and it

  ///also provides several useful additional functionalities.

  ///Most of the member functions and nested classes are documented

  ///only in the concept class.

  ///

  ///An important extra feature of this graph implementation is that

  ///its maps are real \ref concepts::ReferenceMap "reference map"s.

  ///

  ///\sa concepts::Graph

  class ListGraph : public ExtendedListGraphBase {

  private:

    ///ListGraph is \e not copy constructible. Use copyGraph() instead.

    ///ListGraph is \e not copy constructible. Use copyGraph() instead.

    ///

    ListGraph(const ListGraph &) :ExtendedListGraphBase()  {};

    ///\brief Assignment of ListGraph to another one is \e not allowed.

    ///Use copyGraph() instead.

    ///Assignment of ListGraph to another one is \e not allowed.

    ///Use copyGraph() instead.

    void operator=(const ListGraph &) {}

  public:

    /// Constructor

    /// Constructor.

    ///

    ListGraph() {}

    typedef ExtendedListGraphBase Parent;

    typedef Parent::OutArcIt IncEdgeIt;

    /// \brief Add a new node to the graph.

    ///

    /// Add a new node to the graph.

    /// \return the new node.

    Node addNode() { return Parent::addNode(); }

    /// \brief Add a new edge to the graph.

    ///

    /// Add a new edge to the graph with source node \c s

    /// and target node \c t.

    /// \return the new edge.

    Edge addEdge(const Node& s, const Node& t) {

      return Parent::addEdge(s, t);

    }

    /// Node validity check

    /// This function gives back true if the given node is valid,

    /// ie. it is a real node of the graph.

    ///

    /// \warning A Node pointing to a removed item

    /// could become valid again later if new nodes are

    /// added to the graph.

    bool valid(Node n) const { return Parent::valid(n); }

    /// Arc validity check

    /// This function gives back true if the given arc is valid,

    /// ie. it is a real arc of the graph.

    ///

    /// \warning An Arc pointing to a removed item

    /// could become valid again later if new edges are

    /// added to the graph.

    bool valid(Arc a) const { return Parent::valid(a); }

    /// Edge validity check

    /// This function gives back true if the given edge is valid,

    /// ie. it is a real arc of the graph.

    ///

    /// \warning A Edge pointing to a removed item

    /// could become valid again later if new edges are

    /// added to the graph.

    bool valid(Edge e) const { return Parent::valid(e); }

    /// \brief Change the source of \c e to \c n

    ///

    /// This function changes the source of \c e to \c n.

    ///

    ///\note The <tt>ArcIt</tt>s and <tt>InArcIt</tt>s

    ///referencing the changed arc remain

    ///valid. However <tt>OutArcIt</tt>s are invalidated.

    ///

    ///\warning This functionality cannot be used together with the

    ///Snapshot feature.

    void changeSource(Edge e, Node n) {

      Parent::changeSource(e,n);

    }

    /// \brief Change the target of \c e to \c n

    ///

    /// This function changes the target of \c e to \c n.

    ///

    /// \note The <tt>ArcIt</tt>s referencing the changed arc remain

    /// valid. However the other iterators may be invalidated.

    ///

    ///\warning This functionality cannot be used together with the

    ///Snapshot feature.

    void changeTarget(Edge e, Node n) {

      Parent::changeTarget(e,n);

    }

    /// \brief Change the source of \c e to \c n

    ///

    /// This function changes the source of \c e to \c n.

    /// It also changes the proper node of the represented edge.

    ///

    ///\note The <tt>ArcIt</tt>s and <tt>InArcIt</tt>s

    ///referencing the changed arc remain

    ///valid. However <tt>OutArcIt</tt>s are invalidated.

    ///

    ///\warning This functionality cannot be used together with the

    ///Snapshot feature.

    void changeSource(Arc e, Node n) {

      if (Parent::direction(e)) {

        Parent::changeSource(e,n);

      } else {

        Parent::changeTarget(e,n);

      }

    }

    /// \brief Change the target of \c e to \c n

    ///

    /// This function changes the target of \c e to \c n.

    /// It also changes the proper node of the represented edge.

    ///

    ///\note The <tt>ArcIt</tt>s and <tt>OutArcIt</tt>s

    ///referencing the changed arc remain

    ///valid. However <tt>InArcIt</tt>s are invalidated.

    ///

    ///\warning This functionality cannot be used together with the

    ///Snapshot feature.

    void changeTarget(Arc e, Node n) {

      if (Parent::direction(e)) {

        Parent::changeTarget(e,n);

      } else {

        Parent::changeSource(e,n);

      }

    }

    /// \brief Contract two nodes.

    ///

    /// This function contracts two nodes.

    /// Node \p b will be removed but instead of deleting

    /// its neighboring arcs, they will be joined to \p a.

    /// The last parameter \p r controls whether to remove loops. \c true

    /// means that loops will be removed.

    ///

    /// \note The <tt>ArcIt</tt>s referencing a moved arc remain

    /// valid.

    ///

    ///\warning This functionality cannot be used together with the

    ///Snapshot feature.

    void contract(Node a, Node b, bool r = true) {

      for(IncEdgeIt e(*this, b); e!=INVALID;) {

        IncEdgeIt f = e; ++f;

        if (r && runningNode(e) == a) {

          erase(e);

        } else if (source(e) == b) {

          changeSource(e, a);

        } else {

          changeTarget(e, a);

        }

        e = f;

      }

      erase(b);

    }

    /// \brief Class to make a snapshot of the graph and restore

    /// it later.

    ///

    /// Class to make a snapshot of the graph and restore it later.

    ///

    /// The newly added nodes and edges can be removed

    /// using the restore() function.

    ///

    /// \warning Edge and node deletions and other modifications

    /// (e.g. changing nodes of edges, contracting nodes) cannot be

    /// restored. These events invalidate the snapshot.