3  * This file is a part of LEMON, a generic C++ optimization library
 
     5  * Copyright (C) 2003-2006
 
     6  * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
 
     7  * (Egervary Research Group on Combinatorial Optimization, EGRES).
 
     9  * Permission to use, modify and distribute this software is granted
 
    10  * provided that this copyright notice appears in all copies. For
 
    11  * precise terms see the accompanying LICENSE file.
 
    13  * This software is provided "AS IS" with no warranty of any kind,
 
    14  * express or implied, and with no claim as to its suitability for any
 
    19 #ifndef LEMON_BITS_BASE_EXTENDER_H
 
    20 #define LEMON_BITS_BASE_EXTENDER_H
 
    22 #include <lemon/bits/invalid.h>
 
    23 #include <lemon/error.h>
 
    25 #include <lemon/bits/map_extender.h>
 
    26 #include <lemon/bits/default_map.h>
 
    28 #include <lemon/concept_check.h>
 
    29 #include <lemon/concept/maps.h>
 
    33 ///\brief Extenders for the graph types
 
    36   /// \ingroup graphbits
 
    38   /// \brief BaseExtender for the UGraphs
 
    39   template <typename Base>
 
    40   class UndirGraphExtender : public Base {
 
    45     typedef typename Parent::Edge UEdge;
 
    46     typedef typename Parent::Node Node;
 
    48     typedef True UndirectedTag;
 
    50     class Edge : public UEdge {
 
    51       friend class UndirGraphExtender;
 
    56       Edge(const UEdge &ue, bool _forward) :
 
    57         UEdge(ue), forward(_forward) {}
 
    62       /// Invalid edge constructor
 
    63       Edge(Invalid i) : UEdge(i), forward(true) {}
 
    65       bool operator==(const Edge &that) const {
 
    66 	return forward==that.forward && UEdge(*this)==UEdge(that);
 
    68       bool operator!=(const Edge &that) const {
 
    69 	return forward!=that.forward || UEdge(*this)!=UEdge(that);
 
    71       bool operator<(const Edge &that) const {
 
    72 	return forward<that.forward ||
 
    73 	  (!(that.forward<forward) && UEdge(*this)<UEdge(that));
 
    81     /// Source of the given Edge.
 
    82     Node source(const Edge &e) const {
 
    83       return e.forward ? Parent::source(e) : Parent::target(e);
 
    88     /// Target of the given Edge.
 
    89     Node target(const Edge &e) const {
 
    90       return e.forward ? Parent::target(e) : Parent::source(e);
 
    93     /// \brief Directed edge from an undirected edge.
 
    95     /// Returns a directed edge corresponding to the specified UEdge.
 
    96     /// If the given bool is true the given undirected edge and the
 
    97     /// returned edge have the same source node.
 
    98     static Edge direct(const UEdge &ue, bool d) {
 
   102     /// Returns whether the given directed edge is same orientation as the
 
   103     /// corresponding undirected edge.
 
   105     /// \todo reference to the corresponding point of the undirected graph
 
   106     /// concept. "What does the direction of an undirected edge mean?"
 
   107     static bool direction(const Edge &e) { return e.forward; }
 
   113     void first(Edge &e) const {
 
   118     void next(Edge &e) const {
 
   128     void firstOut(Edge &e, const Node &n) const {
 
   129       Parent::firstIn(e,n);
 
   130       if( UEdge(e) != INVALID ) {
 
   134 	Parent::firstOut(e,n);
 
   138     void nextOut(Edge &e) const {
 
   140 	Node n = Parent::target(e);
 
   142 	if( UEdge(e) == INVALID ) {
 
   143 	  Parent::firstOut(e, n);
 
   152     void firstIn(Edge &e, const Node &n) const {
 
   153       Parent::firstOut(e,n);
 
   154       if( UEdge(e) != INVALID ) {
 
   158 	Parent::firstIn(e,n);
 
   162     void nextIn(Edge &e) const {
 
   164 	Node n = Parent::source(e);
 
   166 	if( UEdge(e) == INVALID ) {
 
   167 	  Parent::firstIn(e, n);
 
   176     void firstInc(UEdge &e, bool &d, const Node &n) const {
 
   178       Parent::firstOut(e, n);
 
   179       if (e != INVALID) return;
 
   181       Parent::firstIn(e, n);
 
   184     void nextInc(UEdge &e, bool &d) const {
 
   186 	Node s = Parent::source(e);
 
   188 	if (e != INVALID) return;
 
   190 	Parent::firstIn(e, s);
 
   196     Node nodeFromId(int id) const {
 
   197       return Parent::nodeFromId(id);
 
   200     Edge edgeFromId(int id) const {
 
   201       return direct(Parent::edgeFromId(id >> 1), bool(id & 1));
 
   204     UEdge uEdgeFromId(int id) const {
 
   205       return Parent::edgeFromId(id >> 1);
 
   208     int id(const Node &n) const {
 
   209       return Parent::id(n);
 
   212     int id(const UEdge &e) const {
 
   213       return Parent::id(e);
 
   216     int id(const Edge &e) const {
 
   217       return 2 * Parent::id(e) + int(e.forward);
 
   220     int maxNodeId() const {
 
   221       return Parent::maxNodeId();
 
   224     int maxEdgeId() const {
 
   225       return 2 * Parent::maxEdgeId() + 1;
 
   228     int maxUEdgeId() const {
 
   229       return Parent::maxEdgeId();
 
   233     int edgeNum() const {
 
   234       return 2 * Parent::edgeNum();
 
   237     int uEdgeNum() const {
 
   238       return Parent::edgeNum();
 
   241     Edge findEdge(Node source, Node target, Edge prev) const {
 
   242       if (prev == INVALID) {
 
   243 	UEdge edge = Parent::findEdge(source, target);
 
   244 	if (edge != INVALID) return direct(edge, true);
 
   245 	edge = Parent::findEdge(target, source);
 
   246 	if (edge != INVALID) return direct(edge, false);
 
   247       } else if (direction(prev)) {
 
   248 	UEdge edge = Parent::findEdge(source, target, prev);
 
   249 	if (edge != INVALID) return direct(edge, true);
 
   250 	edge = Parent::findEdge(target, source);
 
   251 	if (edge != INVALID) return direct(edge, false);	
 
   253 	UEdge edge = Parent::findEdge(target, source, prev);
 
   254 	if (edge != INVALID) return direct(edge, false);	      
 
   259     UEdge findUEdge(Node source, Node target, UEdge prev) const {
 
   260       if (prev == INVALID) {
 
   261 	UEdge edge = Parent::findEdge(source, target);
 
   262 	if (edge != INVALID) return edge;
 
   263 	edge = Parent::findEdge(target, source);
 
   264 	if (edge != INVALID) return edge;
 
   265       } else if (Parent::source(prev) == source) {
 
   266 	UEdge edge = Parent::findEdge(source, target, prev);
 
   267 	if (edge != INVALID) return edge;
 
   268 	edge = Parent::findEdge(target, source);
 
   269 	if (edge != INVALID) return edge;	
 
   271 	UEdge edge = Parent::findEdge(target, source, prev);
 
   272 	if (edge != INVALID) return edge;