| [bfae637] | 1 | // | 
|---|
|  | 2 | // Cforall Version 1.0.0 Copyright (C) 2015 University of Waterloo | 
|---|
|  | 3 | // | 
|---|
|  | 4 | // The contents of this file are covered under the licence agreement in the | 
|---|
|  | 5 | // file "LICENCE" distributed with Cforall. | 
|---|
|  | 6 | // | 
|---|
|  | 7 | // ScopedMap.h -- | 
|---|
|  | 8 | // | 
|---|
|  | 9 | // Author           : Aaron B. Moss | 
|---|
|  | 10 | // Created On       : Wed Dec 2 11:37:00 2015 | 
|---|
|  | 11 | // Last Modified By : Aaron B. Moss | 
|---|
|  | 12 | // Last Modified On : Wed Dec 2 11:37:00 2015 | 
|---|
|  | 13 | // Update Count     : 1 | 
|---|
|  | 14 | // | 
|---|
|  | 15 |  | 
|---|
|  | 16 | #ifndef _ERASABLESCOPEDMAP_H | 
|---|
|  | 17 | #define _ERASABLESCOPEDMAP_H | 
|---|
|  | 18 |  | 
|---|
|  | 19 | #include <cassert> | 
|---|
|  | 20 | #include <iterator> | 
|---|
|  | 21 | #include <map> | 
|---|
|  | 22 | #include <utility> | 
|---|
|  | 23 | #include <vector> | 
|---|
|  | 24 |  | 
|---|
|  | 25 | namespace GenPoly { | 
|---|
|  | 26 | /// A map where the items are placed into nested scopes; | 
|---|
|  | 27 | /// inserted items are placed into the innermost scope, lookup looks from the innermost scope outward; | 
|---|
|  | 28 | /// erasing a key means that find() will no longer report any instance of the key in a scope further | 
|---|
|  | 29 | /// out, but the erasure itself is scoped. Key erasure works by inserting a sentinal value into the | 
|---|
|  | 30 | /// value field, and thus only works for Value types where a meaningful sentinal can be chosen. | 
|---|
|  | 31 | template<typename Key, typename Value> | 
|---|
|  | 32 | class ErasableScopedMap { | 
|---|
|  | 33 | typedef std::map< Key, Value > Scope; | 
|---|
|  | 34 | typedef std::vector< Scope > ScopeList; | 
|---|
|  | 35 |  | 
|---|
|  | 36 | ScopeList scopes; ///< scoped list of maps | 
|---|
|  | 37 | Value erased;     ///< sentinal value for erased keys | 
|---|
|  | 38 | public: | 
|---|
|  | 39 | typedef typename Scope::key_type key_type; | 
|---|
|  | 40 | typedef typename Scope::mapped_type mapped_type; | 
|---|
|  | 41 | typedef typename Scope::value_type value_type; | 
|---|
|  | 42 | typedef typename ScopeList::size_type size_type; | 
|---|
|  | 43 | typedef typename ScopeList::difference_type difference_type; | 
|---|
|  | 44 | typedef typename Scope::reference reference; | 
|---|
|  | 45 | typedef typename Scope::const_reference const_reference; | 
|---|
|  | 46 | typedef typename Scope::pointer pointer; | 
|---|
|  | 47 | typedef typename Scope::const_pointer const_pointer; | 
|---|
|  | 48 |  | 
|---|
|  | 49 | class iterator : public std::iterator< std::bidirectional_iterator_tag, | 
|---|
|  | 50 | value_type > { | 
|---|
|  | 51 | friend class ErasableScopedMap; | 
|---|
|  | 52 | friend class const_iterator; | 
|---|
|  | 53 | typedef typename std::map< Key, Value >::iterator wrapped_iterator; | 
|---|
|  | 54 | typedef typename std::vector< std::map< Key, Value > > scope_list; | 
|---|
|  | 55 | typedef typename scope_list::size_type size_type; | 
|---|
|  | 56 |  | 
|---|
|  | 57 | /// Checks if this iterator points to a valid item | 
|---|
|  | 58 | bool is_valid() const { | 
|---|
|  | 59 | return it != map->scopes[i].end() && it->second != map->erased; | 
|---|
|  | 60 | } | 
|---|
|  | 61 |  | 
|---|
|  | 62 | /// Increments on invalid | 
|---|
|  | 63 | iterator& next_valid() { | 
|---|
|  | 64 | if ( ! is_valid() ) { ++(*this); } | 
|---|
|  | 65 | return *this; | 
|---|
|  | 66 | } | 
|---|
|  | 67 |  | 
|---|
|  | 68 | /// Decrements on invalid | 
|---|
|  | 69 | iterator& prev_valid() { | 
|---|
|  | 70 | if ( ! is_valid() ) { --(*this); } | 
|---|
|  | 71 | return *this; | 
|---|
|  | 72 | } | 
|---|
|  | 73 |  | 
|---|
|  | 74 | iterator(ErasableScopedMap< Key, Value > const &_map, const wrapped_iterator &_it, size_type _i) | 
|---|
|  | 75 | : map(&_map), it(_it), i(_i) {} | 
|---|
|  | 76 |  | 
|---|
|  | 77 | public: | 
|---|
|  | 78 | iterator(const iterator &that) : map(that.map), it(that.it), i(that.i) {} | 
|---|
|  | 79 | iterator& operator= (const iterator &that) { | 
|---|
|  | 80 | map = that.map; i = that.i; it = that.it; | 
|---|
|  | 81 | return *this; | 
|---|
|  | 82 | } | 
|---|
|  | 83 |  | 
|---|
|  | 84 | reference operator* () { return *it; } | 
|---|
|  | 85 | pointer operator-> () { return it.operator->(); } | 
|---|
|  | 86 |  | 
|---|
|  | 87 | iterator& operator++ () { | 
|---|
|  | 88 | if ( it == map->scopes[i].end() ) { | 
|---|
|  | 89 | if ( i == 0 ) return *this; | 
|---|
|  | 90 | --i; | 
|---|
|  | 91 | it = map->scopes[i].begin(); | 
|---|
|  | 92 | } else { | 
|---|
|  | 93 | ++it; | 
|---|
|  | 94 | } | 
|---|
|  | 95 | return next_valid(); | 
|---|
|  | 96 | } | 
|---|
|  | 97 | iterator& operator++ (int) { iterator tmp = *this; ++(*this); return tmp; } | 
|---|
|  | 98 |  | 
|---|
|  | 99 | iterator& operator-- () { | 
|---|
|  | 100 | // may fail if this is the begin iterator; allowed by STL spec | 
|---|
|  | 101 | if ( it == map->scopes[i].begin() ) { | 
|---|
|  | 102 | ++i; | 
|---|
|  | 103 | it = map->scopes[i].end(); | 
|---|
|  | 104 | } | 
|---|
|  | 105 | --it; | 
|---|
|  | 106 | return prev_valid(); | 
|---|
|  | 107 | } | 
|---|
|  | 108 | iterator& operator-- (int) { iterator tmp = *this; --(*this); return tmp; } | 
|---|
|  | 109 |  | 
|---|
|  | 110 | bool operator== (const iterator &that) { | 
|---|
|  | 111 | return map == that.map && i == that.i && it == that.it; | 
|---|
|  | 112 | } | 
|---|
|  | 113 | bool operator!= (const iterator &that) { return !( *this == that ); } | 
|---|
|  | 114 |  | 
|---|
|  | 115 | private: | 
|---|
|  | 116 | ErasableScopedMap< Key, Value > const *map; | 
|---|
|  | 117 | wrapped_iterator it; | 
|---|
|  | 118 | size_type i; | 
|---|
|  | 119 | }; | 
|---|
|  | 120 |  | 
|---|
|  | 121 | class const_iterator : public std::iterator< std::bidirectional_iterator_tag, | 
|---|
|  | 122 | value_type > { | 
|---|
|  | 123 | friend class ErasableScopedMap; | 
|---|
|  | 124 | typedef typename std::map< Key, Value >::iterator wrapped_iterator; | 
|---|
|  | 125 | typedef typename std::map< Key, Value >::const_iterator wrapped_const_iterator; | 
|---|
|  | 126 | typedef typename std::vector< std::map< Key, Value > > scope_list; | 
|---|
|  | 127 | typedef typename scope_list::size_type size_type; | 
|---|
|  | 128 |  | 
|---|
|  | 129 | /// Checks if this iterator points to a valid item | 
|---|
|  | 130 | bool is_valid() const { | 
|---|
|  | 131 | return it != map->scopes[i].end() && it->second != map->erased; | 
|---|
|  | 132 | } | 
|---|
|  | 133 |  | 
|---|
|  | 134 | /// Increments on invalid | 
|---|
|  | 135 | const_iterator& next_valid() { | 
|---|
|  | 136 | if ( ! is_valid() ) { ++(*this); } | 
|---|
|  | 137 | return *this; | 
|---|
|  | 138 | } | 
|---|
|  | 139 |  | 
|---|
|  | 140 | /// Decrements on invalid | 
|---|
|  | 141 | const_iterator& prev_valid() { | 
|---|
|  | 142 | if ( ! is_valid() ) { --(*this); } | 
|---|
|  | 143 | return *this; | 
|---|
|  | 144 | } | 
|---|
|  | 145 |  | 
|---|
|  | 146 | const_iterator(ErasableScopedMap< Key, Value > const &_map, const wrapped_const_iterator &_it, size_type _i) | 
|---|
|  | 147 | : map(&_map), it(_it), i(_i) {} | 
|---|
|  | 148 | public: | 
|---|
|  | 149 | const_iterator(const iterator &that) : map(that.map), it(that.it), i(that.i) {} | 
|---|
|  | 150 | const_iterator(const const_iterator &that) : map(that.map), it(that.it), i(that.i) {} | 
|---|
|  | 151 | const_iterator& operator= (const iterator &that) { | 
|---|
|  | 152 | map = that.map; i = that.i; it = that.it; | 
|---|
|  | 153 | return *this; | 
|---|
|  | 154 | } | 
|---|
|  | 155 | const_iterator& operator= (const const_iterator &that) { | 
|---|
|  | 156 | map = that.map; i = that.i; it = that.it; | 
|---|
|  | 157 | return *this; | 
|---|
|  | 158 | } | 
|---|
|  | 159 |  | 
|---|
|  | 160 | const_reference operator* () { return *it; } | 
|---|
|  | 161 | const_pointer operator-> () { return it.operator->(); } | 
|---|
|  | 162 |  | 
|---|
|  | 163 | const_iterator& operator++ () { | 
|---|
|  | 164 | if ( it == map->scopes[i].end() ) { | 
|---|
|  | 165 | if ( i == 0 ) return *this; | 
|---|
|  | 166 | --i; | 
|---|
|  | 167 | it = map->scopes[i].begin(); | 
|---|
|  | 168 | } else { | 
|---|
|  | 169 | ++it; | 
|---|
|  | 170 | } | 
|---|
|  | 171 | return next_valid(); | 
|---|
|  | 172 | } | 
|---|
|  | 173 | const_iterator& operator++ (int) { const_iterator tmp = *this; ++(*this); return tmp; } | 
|---|
|  | 174 |  | 
|---|
|  | 175 | const_iterator& operator-- () { | 
|---|
|  | 176 | // may fail if this is the begin iterator; allowed by STL spec | 
|---|
|  | 177 | if ( it == map->scopes[i].begin() ) { | 
|---|
|  | 178 | ++i; | 
|---|
|  | 179 | it = map->scopes[i].end(); | 
|---|
|  | 180 | } | 
|---|
|  | 181 | --it; | 
|---|
|  | 182 | return prev_valid(); | 
|---|
|  | 183 | } | 
|---|
|  | 184 | const_iterator& operator-- (int) { const_iterator tmp = *this; --(*this); return tmp; } | 
|---|
|  | 185 |  | 
|---|
|  | 186 | bool operator== (const const_iterator &that) { | 
|---|
|  | 187 | return map == that.map && i == that.i && it == that.it; | 
|---|
|  | 188 | } | 
|---|
|  | 189 | bool operator!= (const const_iterator &that) { return !( *this == that ); } | 
|---|
|  | 190 |  | 
|---|
|  | 191 | private: | 
|---|
|  | 192 | ErasableScopedMap< Key, Value > const *map; | 
|---|
|  | 193 | wrapped_const_iterator it; | 
|---|
|  | 194 | size_type i; | 
|---|
|  | 195 | }; | 
|---|
|  | 196 |  | 
|---|
|  | 197 | /// Starts a new scope | 
|---|
|  | 198 | void beginScope() { | 
|---|
|  | 199 | Scope scope; | 
|---|
|  | 200 | scopes.push_back(scope); | 
|---|
|  | 201 | } | 
|---|
|  | 202 |  | 
|---|
|  | 203 | /// Ends a scope; invalidates any iterators pointing to elements of that scope | 
|---|
|  | 204 | void endScope() { | 
|---|
|  | 205 | scopes.pop_back(); | 
|---|
|  | 206 | assert( ! scopes.empty() ); | 
|---|
|  | 207 | } | 
|---|
|  | 208 |  | 
|---|
|  | 209 | /// Default constructor initializes with one scope | 
|---|
|  | 210 | ErasableScopedMap( const Value &erased_ ) : erased( erased_ ) { beginScope(); } | 
|---|
|  | 211 |  | 
|---|
|  | 212 | iterator begin() { return iterator(*this, scopes.back().begin(), scopes.size()-1).next_valid(); } | 
|---|
|  | 213 | const_iterator begin() const { return const_iterator(*this, scopes.back().begin(), scopes.size()-1).next_valid(); } | 
|---|
|  | 214 | const_iterator cbegin() const { return const_iterator(*this, scopes.back().begin(), scopes.size()-1).next_valid(); } | 
|---|
|  | 215 | iterator end() { return iterator(*this, scopes[0].end(), 0); } | 
|---|
|  | 216 | const_iterator end() const { return const_iterator(*this, scopes[0].end(), 0); } | 
|---|
|  | 217 | const_iterator cend() const { return const_iterator(*this, scopes[0].end(), 0); } | 
|---|
|  | 218 |  | 
|---|
|  | 219 | /// Gets the index of the current scope (counted from 1) | 
|---|
|  | 220 | size_type currentScope() const { return scopes.size(); } | 
|---|
|  | 221 |  | 
|---|
|  | 222 | /// Finds the given key in the outermost scope it occurs; returns end() for none such | 
|---|
|  | 223 | iterator find( const Key &key ) { | 
|---|
|  | 224 | for ( size_type i = scopes.size() - 1; ; --i ) { | 
|---|
|  | 225 | typename Scope::iterator val = scopes[i].find( key ); | 
|---|
|  | 226 | if ( val != scopes[i].end() ) { | 
|---|
|  | 227 | return val->second == erased ? end() : iterator( *this, val, i ); | 
|---|
|  | 228 | } | 
|---|
|  | 229 | if ( i == 0 ) break; | 
|---|
|  | 230 | } | 
|---|
|  | 231 | return end(); | 
|---|
|  | 232 | } | 
|---|
|  | 233 | const_iterator find( const Key &key ) const { | 
|---|
|  | 234 | return const_iterator( const_cast< ErasableScopedMap< Key, Value >* >(this)->find( key ) ); | 
|---|
|  | 235 | } | 
|---|
|  | 236 |  | 
|---|
|  | 237 | /// Finds the given key in the outermost scope inside the given scope where it occurs | 
|---|
|  | 238 | iterator findNext( const_iterator &it, const Key &key ) { | 
|---|
|  | 239 | if ( it.i == 0 ) return end(); | 
|---|
|  | 240 | for ( size_type i = it.i - 1; ; --i ) { | 
|---|
|  | 241 | typename Scope::iterator val = scopes[i].find( key ); | 
|---|
|  | 242 | if ( val != scopes[i].end() ) { | 
|---|
|  | 243 | return val->second == erased ? end() : iterator( *this, val, i ); | 
|---|
|  | 244 | } | 
|---|
|  | 245 | if ( i == 0 ) break; | 
|---|
|  | 246 | } | 
|---|
|  | 247 | return end(); | 
|---|
|  | 248 | } | 
|---|
|  | 249 | const_iterator findNext( const_iterator &it, const Key &key ) const { | 
|---|
|  | 250 | return const_iterator( const_cast< ErasableScopedMap< Key, Value >* >(this)->findNext( it, key ) ); | 
|---|
|  | 251 | } | 
|---|
|  | 252 |  | 
|---|
|  | 253 | /// Inserts the given key-value pair into the outermost scope | 
|---|
|  | 254 | std::pair< iterator, bool > insert( const value_type &value ) { | 
|---|
|  | 255 | std::pair< typename Scope::iterator, bool > res = scopes.back().insert( value ); | 
|---|
|  | 256 | return std::make_pair( iterator(*this, res.first, scopes.size()-1), res.second ); | 
|---|
|  | 257 | } | 
|---|
|  | 258 | std::pair< iterator, bool > insert( const Key &key, const Value &value ) { return insert( std::make_pair( key, value ) ); } | 
|---|
|  | 259 |  | 
|---|
|  | 260 | /// Marks the given element as erased from this scope inward; returns 1 for erased an element, 0 otherwise | 
|---|
|  | 261 | size_type erase( const Key &key ) { | 
|---|
|  | 262 | typename Scope::iterator val = scopes.back().find( key ); | 
|---|
|  | 263 | if ( val != scopes.back().end() ) { | 
|---|
|  | 264 | val->second = erased; | 
|---|
|  | 265 | return 1; | 
|---|
|  | 266 | } else { | 
|---|
|  | 267 | scopes.back().insert( val, std::make_pair( key, erased ) ); | 
|---|
|  | 268 | return 0; | 
|---|
|  | 269 | } | 
|---|
|  | 270 | } | 
|---|
|  | 271 |  | 
|---|
|  | 272 | Value& operator[] ( const Key &key ) { | 
|---|
|  | 273 | iterator slot = find( key ); | 
|---|
|  | 274 | if ( slot != end() ) return slot->second; | 
|---|
|  | 275 | return insert( key, Value() ).first->second; | 
|---|
|  | 276 | } | 
|---|
|  | 277 | }; | 
|---|
|  | 278 | } // namespace GenPoly | 
|---|
|  | 279 |  | 
|---|
|  | 280 | #endif // _ERASABLESCOPEDMAP_H | 
|---|
|  | 281 |  | 
|---|
|  | 282 | // Local Variables: // | 
|---|
|  | 283 | // tab-width: 4 // | 
|---|
|  | 284 | // mode: c++ // | 
|---|
|  | 285 | // compile-command: "make install" // | 
|---|
|  | 286 | // End: // | 
|---|