src/hugo/vector_map_factory.h
author hegyi
Wed, 08 Sep 2004 11:58:06 +0000
changeset 821 283a7fe3a00e
parent 804 6874a72dbdc5
permissions -rw-r--r--
This is needed by path.h
     1 // -*- c++ -*-
     2 #ifndef VECTOR_MAP_H
     3 #define VECTOR_MAP_H
     4 
     5 #include <vector>
     6 
     7 #include <hugo/extended_pair.h>
     8 
     9 ///\ingroup graphmapfactory
    10 ///\file
    11 ///\brief Vector based graph maps.
    12 
    13 namespace hugo {
    14   
    15   /// \addtogroup graphmapfactory
    16   /// @{
    17   
    18   /** The VectorMapFactory template class is a factory class
    19    *  to create maps for the edge and nodes. This map factory
    20    *  uses the std::vector to implement the container function.
    21    *
    22    *  The template parameter is the MapRegistry that the maps
    23    *  will belong to.
    24    * 
    25    * \todo It should use a faster initialization using the maxNodeId() or
    26    * maxEdgeId() function of the graph istead of iterating through each
    27    * edge/node.
    28    */
    29 	
    30   template <typename MapRegistry>
    31   class VectorMapFactory {
    32   public:
    33 		
    34     /// The graph type of the maps. 
    35     typedef typename MapRegistry::Graph Graph;
    36     /// The key type of the maps.
    37     typedef typename MapRegistry::KeyType KeyType;
    38     /// The iterator to iterate on the keys.
    39     typedef typename MapRegistry::KeyIt KeyIt;
    40 
    41     /// The MapBase of the Map which imlements the core regisitry function.
    42     typedef typename MapRegistry::MapBase MapBase;
    43 
    44 		
    45     /** The template Map type.
    46      */
    47     template <typename V> 
    48     class Map : public MapBase {
    49 
    50       typedef std::vector<V> Container;	
    51 
    52     public:
    53 
    54       /// The value type of the map.
    55       typedef V ValueType;
    56 
    57       /// The value type of the map.
    58       typedef V Value;
    59       /// The reference type of the map;
    60       typedef typename Container::reference Reference;
    61       /// The pointer type of the map;
    62       typedef typename Container::pointer Pointer;
    63 
    64       /// The const value type of the map.
    65       typedef const Value ConstValue;
    66       /// The const reference type of the map;
    67       typedef typename Container::const_reference ConstReference;
    68       /// The pointer type of the map;
    69       typedef typename Container::const_pointer ConstPointer;
    70 
    71       /** Default constructor for the map.
    72        */
    73       Map() {}
    74 		
    75       /** Graph and Registry initialized map constructor.
    76        */
    77       Map(const Graph& g, MapRegistry& r) : MapBase(g, r) {
    78 	init();
    79       }
    80 
    81       /** Constructor to use default value to initialize the map. 
    82        */
    83       Map(const Graph& g, MapRegistry& r, const Value& v) : MapBase(g, r) {
    84 	for (KeyIt it(*getGraph()); it != INVALID; ++it) {
    85           int id = getGraph()->id(it);
    86 	  if (id >= (int)container.size()) {
    87 	    container.resize(id + 1);
    88 	  }
    89 	  set(it, v);
    90         }
    91       }
    92 
    93       /** Constructor to copy a map of an other map type.
    94        */
    95       template <typename CMap> Map(const CMap& copy) : MapBase(copy) {
    96 	if (getGraph()) {
    97 	  for (KeyIt it(*getGraph()); it != INVALID; ++it) {
    98 	    int id = getGraph()->id(it);
    99 	    if (id >= (int)container.size()) {
   100 	      container.resize(id + 1);
   101 	    }
   102 	    set(it, copy[it]);
   103 	  }
   104 	}
   105       }
   106 
   107       /** Assign operator to copy a map an other map type.
   108        */
   109       template <typename CMap> Map& operator=(const CMap& copy) {
   110 	if (getGraph()) {
   111 	  destroy();
   112 	} 
   113 	this->MapBase::operator=(copy);
   114 	if (getGraph()) {
   115 	  for (KeyIt it(*getGraph()); it != INVALID; ++it) {
   116 	    int id = getGraph()->id(it);
   117 	    if (id >= (int)container.size()) {
   118 	      container.resize(id + 1);
   119 	    }
   120 	    set(it, copy[it]);
   121 	  }
   122 	}
   123 	return *this;
   124       }
   125 
   126       /** The destructor of the map.
   127        */
   128       virtual ~Map() {
   129       }
   130 		
   131       /**
   132        * The subscript operator. The map can be subscripted by the
   133        * actual keys of the graph. 
   134        */
   135       Reference operator[](const KeyType& key) {
   136 	int id = getGraph()->id(key);
   137 	return container[id];
   138       } 
   139 		
   140       /**
   141        * The const subscript operator. The map can be subscripted by the
   142        * actual keys of the graph. 
   143        */
   144       ConstReference operator[](const KeyType& key) const {
   145 	int id = getGraph()->id(key);
   146 	return container[id];
   147       }
   148 
   149       /** Setter function of the map. Equivalent with map[key] = val.
   150        *  This is a compatibility feature with the not dereferable maps.
   151        */
   152       void set(const KeyType& key, const Value& val) {
   153 	int id = getGraph()->id(key);
   154 	container[id] = val;
   155       }
   156 		
   157       /** Add a new key to the map. It called by the map registry.
   158        */
   159       void add(const KeyType& key) {
   160 	int id = getGraph()->id(key);
   161 	if (id >= (int)container.size()) {
   162 	  container.resize(id + 1);
   163 	}
   164       }
   165 		
   166       /** Erase a key from the map. It called by the map registry.
   167        */
   168       void erase(const KeyType& key) {}
   169 
   170       /** Clear the data structure.
   171        */
   172       void clear() { 
   173 	container.clear();
   174       }
   175 
   176       class iterator;
   177       class const_iterator;
   178 
   179       /** Compatible iterator with the stl maps' iterators.
   180        *  It iterates on pairs of a key and a value.
   181        */
   182       class iterator {
   183 	friend class Map;
   184 	friend class const_iterator;
   185       private:
   186 
   187 	/** Private constructor to initalize the the iterators returned
   188 	 *  by the begin() and end().
   189 	 */
   190 	iterator (Map& pmap, const KeyIt& pit) : map(&pmap), it(pit) {}
   191 
   192       public:
   193 
   194 	/** Default constructor. 
   195 	 */
   196 	iterator() {}
   197 
   198 	typedef extended_pair<const KeyType&, const KeyType&, 
   199 			      Map::Reference, Map::Reference> Reference;
   200 
   201 	/** Dereference operator for map.
   202 	 */	 
   203 	Reference operator*() {
   204 	  return Reference(it, (*map)[it]);
   205 	}
   206 
   207 	class Pointer {
   208 	  friend class iterator;
   209 	private:
   210 	  Reference data;
   211 	  Pointer(const KeyType& key, Map::Reference val) : data(key, val) {}
   212 	public:
   213 	  Reference* operator->() {return &data;}
   214 	};
   215 
   216 	/** Arrow operator for map.
   217 	 */	 
   218 	Pointer operator->() {
   219 	  return Pointer(it, ((*map)[it])); 
   220 	}
   221 
   222 	/** The pre increment operator of the map.
   223 	 */
   224 	iterator& operator++() { 
   225 	  ++it; 
   226 	  return *this; 
   227 	}
   228 
   229 	/** The post increment operator of the map.
   230 	 */
   231 	iterator operator++(int) { 
   232 	  iterator tmp(it); 
   233 	  ++it; 
   234 	  return tmp; 
   235 	}
   236 
   237 	/** The equality operator of the map.
   238 	 */
   239 	bool operator==(const_iterator p_it) {
   240 	  return p_it.it == it;
   241 	}
   242 	
   243 	/** The not-equality operator of the map.
   244 	 */
   245 	bool operator!=(const_iterator p_it) {
   246 	  return !(*this == p_it);
   247 	}
   248 
   249 	
   250       private:
   251 	Map* map;
   252 	KeyIt it;
   253       };
   254 
   255       /** Returns the begin iterator of the map.
   256        */
   257       iterator begin() {
   258 	return iterator(*this, KeyIt(*getGraph()));
   259       }
   260 
   261       /** Returns the end iterator of the map.
   262        */
   263       iterator end() {
   264 	return iterator(*this, INVALID);
   265       }
   266 
   267       class const_iterator {
   268 	friend class Map;
   269 	friend class iterator;
   270       private:
   271 
   272 	/** Private constructor to initalize the the iterators returned
   273 	 *  by the begin() and end().
   274 	 */
   275 	const_iterator (const Map& pmap, const KeyIt& pit) 
   276 	  : map(&pmap), it(pit) {}
   277 
   278       public:
   279 
   280 	/** Default constructor. 
   281 	 */
   282 	const_iterator() {}
   283 
   284 	/** Constructor to convert iterator to const_iterator.
   285 	 */
   286 	const_iterator(iterator p_it) : map(p_it.map), it(p_it.it) {}
   287       
   288 	typedef extended_pair<const KeyType&, const KeyType&, 
   289 	  Map::ConstReference, Map::ConstReference> Reference;
   290 
   291 	/** Dereference operator for map.
   292 	 */	 
   293 	Reference operator*() {
   294 	  return Reference(it, (*map)[it]);
   295 	}
   296 
   297 
   298 	class Pointer {
   299 	  friend class const_iterator;
   300 	private:
   301 	  Reference data;
   302 	  Pointer(const KeyType& key, Map::ConstReference val) 
   303 	    : data(key, val) {}
   304 	public:
   305 	  Reference* operator->() {return &data;}
   306 	};
   307 
   308 	/** Arrow operator for map.
   309 	 */	 
   310 	Pointer operator->() {
   311 	  return Pointer(it, ((*map)[it])); 
   312 	}
   313 
   314 	/** The pre increment operator of the map.
   315 	 */
   316 	const_iterator& operator++() { 
   317 	  ++it; 
   318 	  return *this; 
   319 	}
   320 
   321 	/** The post increment operator of the map.
   322 	 */
   323 	const_iterator operator++(int) { 
   324 	  const_iterator tmp(it); 
   325 	  ++it; 
   326 	  return tmp; 
   327 	}
   328 
   329 	/** The equality operator of the map.
   330 	 */
   331 	bool operator==(const_iterator p_it) {
   332 	  return p_it.it == it;
   333 	}
   334 	
   335 	/** The not-equality operator of the map.
   336 	 */
   337 	bool operator!=(const_iterator p_it) {
   338 	  return !(*this == p_it);
   339 	}
   340 	
   341 
   342       private:
   343 	const Map* map;
   344 	KeyIt it;
   345       };
   346 
   347       /** Returns the begin const_iterator of the map.
   348        */
   349       const_iterator begin() const {
   350 	return const_iterator(*this, KeyIt(*getGraph()));
   351       }
   352 
   353       /** Returns the end const_iterator of the map.
   354        */
   355       const_iterator end() const {
   356 	return const_iterator(*this, INVALID);
   357       }
   358 
   359       private:
   360 		
   361       Container container;
   362 
   363     };
   364 		
   365   };
   366 
   367   
   368   /// @}
   369   
   370 
   371 }
   372 
   373 #endif