| 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 _SCOPEDMAP_H | 
|---|
| 17 | #define _SCOPEDMAP_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 | template<typename Key, typename Value> | 
|---|
| 29 | class ScopedMap { | 
|---|
| 30 | typedef std::map< Key, Value > Scope; | 
|---|
| 31 | typedef std::vector< Scope > ScopeList; | 
|---|
| 32 |  | 
|---|
| 33 | ScopeList scopes; ///< scoped list of maps | 
|---|
| 34 | public: | 
|---|
| 35 | typedef typename Scope::key_type key_type; | 
|---|
| 36 | typedef typename Scope::mapped_type mapped_type; | 
|---|
| 37 | typedef typename Scope::value_type value_type; | 
|---|
| 38 | typedef typename ScopeList::size_type size_type; | 
|---|
| 39 | typedef typename ScopeList::difference_type difference_type; | 
|---|
| 40 | typedef typename Scope::reference reference; | 
|---|
| 41 | typedef typename Scope::const_reference const_reference; | 
|---|
| 42 | typedef typename Scope::pointer pointer; | 
|---|
| 43 | typedef typename Scope::const_pointer const_pointer; | 
|---|
| 44 |  | 
|---|
| 45 | class iterator : public std::iterator< std::bidirectional_iterator_tag, | 
|---|
| 46 | value_type > { | 
|---|
| 47 | friend class ScopedMap; | 
|---|
| 48 | friend class const_iterator; | 
|---|
| 49 | typedef typename std::map< Key, Value >::iterator wrapped_iterator; | 
|---|
| 50 | typedef typename std::vector< std::map< Key, Value > > scope_list; | 
|---|
| 51 | typedef typename scope_list::size_type size_type; | 
|---|
| 52 |  | 
|---|
| 53 | /// Checks if this iterator points to a valid item | 
|---|
| 54 | bool is_valid() const { | 
|---|
| 55 | return it != (*scopes)[i].end(); | 
|---|
| 56 | } | 
|---|
| 57 |  | 
|---|
| 58 | /// Increments on invalid | 
|---|
| 59 | iterator& next_valid() { | 
|---|
| 60 | if ( ! is_valid() ) { ++(*this); } | 
|---|
| 61 | return *this; | 
|---|
| 62 | } | 
|---|
| 63 |  | 
|---|
| 64 | /// Decrements on invalid | 
|---|
| 65 | iterator& prev_valid() { | 
|---|
| 66 | if ( ! is_valid() ) { --(*this); } | 
|---|
| 67 | return *this; | 
|---|
| 68 | } | 
|---|
| 69 |  | 
|---|
| 70 | iterator(scope_list const &_scopes, const wrapped_iterator &_it, size_type _i) | 
|---|
| 71 | : scopes(&_scopes), it(_it), i(_i) {} | 
|---|
| 72 | public: | 
|---|
| 73 | iterator(const iterator &that) : scopes(that.scopes), it(that.it), i(that.i) {} | 
|---|
| 74 | iterator& operator= (const iterator &that) { | 
|---|
| 75 | scopes = that.scopes; i = that.i; it = that.it; | 
|---|
| 76 | return *this; | 
|---|
| 77 | } | 
|---|
| 78 |  | 
|---|
| 79 | reference operator* () { return *it; } | 
|---|
| 80 | pointer operator-> () { return it.operator->(); } | 
|---|
| 81 |  | 
|---|
| 82 | iterator& operator++ () { | 
|---|
| 83 | if ( it == (*scopes)[i].end() ) { | 
|---|
| 84 | if ( i == 0 ) return *this; | 
|---|
| 85 | --i; | 
|---|
| 86 | it = (*scopes)[i].begin(); | 
|---|
| 87 | } else { | 
|---|
| 88 | ++it; | 
|---|
| 89 | } | 
|---|
| 90 | return next_valid(); | 
|---|
| 91 | } | 
|---|
| 92 | iterator operator++ (int) { iterator tmp = *this; ++(*this); return tmp; } | 
|---|
| 93 |  | 
|---|
| 94 | iterator& operator-- () { | 
|---|
| 95 | // may fail if this is the begin iterator; allowed by STL spec | 
|---|
| 96 | if ( it == (*scopes)[i].begin() ) { | 
|---|
| 97 | ++i; | 
|---|
| 98 | it = (*scopes)[i].end(); | 
|---|
| 99 | } | 
|---|
| 100 | --it; | 
|---|
| 101 | return prev_valid(); | 
|---|
| 102 | } | 
|---|
| 103 | iterator operator-- (int) { iterator tmp = *this; --(*this); return tmp; } | 
|---|
| 104 |  | 
|---|
| 105 | bool operator== (const iterator &that) { | 
|---|
| 106 | return scopes == that.scopes && i == that.i && it == that.it; | 
|---|
| 107 | } | 
|---|
| 108 | bool operator!= (const iterator &that) { return !( *this == that ); } | 
|---|
| 109 |  | 
|---|
| 110 | private: | 
|---|
| 111 | scope_list const *scopes; | 
|---|
| 112 | wrapped_iterator it; | 
|---|
| 113 | size_type i; | 
|---|
| 114 | }; | 
|---|
| 115 |  | 
|---|
| 116 | class const_iterator : public std::iterator< std::bidirectional_iterator_tag, | 
|---|
| 117 | value_type > { | 
|---|
| 118 | friend class ScopedMap; | 
|---|
| 119 | typedef typename std::map< Key, Value >::iterator wrapped_iterator; | 
|---|
| 120 | typedef typename std::map< Key, Value >::const_iterator wrapped_const_iterator; | 
|---|
| 121 | typedef typename std::vector< std::map< Key, Value > > scope_list; | 
|---|
| 122 | typedef typename scope_list::size_type size_type; | 
|---|
| 123 |  | 
|---|
| 124 | /// Checks if this iterator points to a valid item | 
|---|
| 125 | bool is_valid() const { | 
|---|
| 126 | return it != (*scopes)[i].end(); | 
|---|
| 127 | } | 
|---|
| 128 |  | 
|---|
| 129 | /// Increments on invalid | 
|---|
| 130 | const_iterator& next_valid() { | 
|---|
| 131 | if ( ! is_valid() ) { ++(*this); } | 
|---|
| 132 | return *this; | 
|---|
| 133 | } | 
|---|
| 134 |  | 
|---|
| 135 | /// Decrements on invalid | 
|---|
| 136 | const_iterator& prev_valid() { | 
|---|
| 137 | if ( ! is_valid() ) { --(*this); } | 
|---|
| 138 | return *this; | 
|---|
| 139 | } | 
|---|
| 140 |  | 
|---|
| 141 | const_iterator(scope_list const &_scopes, const wrapped_const_iterator &_it, size_type _i) | 
|---|
| 142 | : scopes(&_scopes), it(_it), i(_i) {} | 
|---|
| 143 | public: | 
|---|
| 144 | const_iterator(const iterator &that) : scopes(that.scopes), it(that.it), i(that.i) {} | 
|---|
| 145 | const_iterator(const const_iterator &that) : scopes(that.scopes), it(that.it), i(that.i) {} | 
|---|
| 146 | const_iterator& operator= (const iterator &that) { | 
|---|
| 147 | scopes = that.scopes; i = that.i; it = that.it; | 
|---|
| 148 | return *this; | 
|---|
| 149 | } | 
|---|
| 150 | const_iterator& operator= (const const_iterator &that) { | 
|---|
| 151 | scopes = that.scopes; i = that.i; it = that.it; | 
|---|
| 152 | return *this; | 
|---|
| 153 | } | 
|---|
| 154 |  | 
|---|
| 155 | const_reference operator* () { return *it; } | 
|---|
| 156 | const_pointer operator-> () { return it.operator->(); } | 
|---|
| 157 |  | 
|---|
| 158 | const_iterator& operator++ () { | 
|---|
| 159 | if ( it == (*scopes)[i].end() ) { | 
|---|
| 160 | if ( i == 0 ) return *this; | 
|---|
| 161 | --i; | 
|---|
| 162 | it = (*scopes)[i].begin(); | 
|---|
| 163 | } else { | 
|---|
| 164 | ++it; | 
|---|
| 165 | } | 
|---|
| 166 | return next_valid(); | 
|---|
| 167 | } | 
|---|
| 168 | const_iterator operator++ (int) { const_iterator tmp = *this; ++(*this); return tmp; } | 
|---|
| 169 |  | 
|---|
| 170 | const_iterator& operator-- () { | 
|---|
| 171 | // may fail if this is the begin iterator; allowed by STL spec | 
|---|
| 172 | if ( it == (*scopes)[i].begin() ) { | 
|---|
| 173 | ++i; | 
|---|
| 174 | it = (*scopes)[i].end(); | 
|---|
| 175 | } | 
|---|
| 176 | --it; | 
|---|
| 177 | return prev_valid(); | 
|---|
| 178 | } | 
|---|
| 179 | const_iterator operator-- (int) { const_iterator tmp = *this; --(*this); return tmp; } | 
|---|
| 180 |  | 
|---|
| 181 | bool operator== (const const_iterator &that) { | 
|---|
| 182 | return scopes == that.scopes && i == that.i && it == that.it; | 
|---|
| 183 | } | 
|---|
| 184 | bool operator!= (const const_iterator &that) { return !( *this == that ); } | 
|---|
| 185 |  | 
|---|
| 186 | private: | 
|---|
| 187 | scope_list const *scopes; | 
|---|
| 188 | wrapped_const_iterator it; | 
|---|
| 189 | size_type i; | 
|---|
| 190 | }; | 
|---|
| 191 |  | 
|---|
| 192 | /// Starts a new scope | 
|---|
| 193 | void beginScope() { | 
|---|
| 194 | Scope scope; | 
|---|
| 195 | scopes.push_back(scope); | 
|---|
| 196 | } | 
|---|
| 197 |  | 
|---|
| 198 | /// Ends a scope; invalidates any iterators pointing to elements of that scope | 
|---|
| 199 | void endScope() { | 
|---|
| 200 | scopes.pop_back(); | 
|---|
| 201 | assert( ! scopes.empty() ); | 
|---|
| 202 | } | 
|---|
| 203 |  | 
|---|
| 204 | /// Default constructor initializes with one scope | 
|---|
| 205 | ScopedMap() { beginScope(); } | 
|---|
| 206 |  | 
|---|
| 207 | iterator begin() { return iterator(scopes, scopes.back().begin(), scopes.size()-1).next_valid(); } | 
|---|
| 208 | const_iterator begin() const { return const_iterator(scopes, scopes.back().begin(), scopes.size()-1).next_valid(); } | 
|---|
| 209 | const_iterator cbegin() const { return const_iterator(scopes, scopes.back().begin(), scopes.size()-1).next_valid(); } | 
|---|
| 210 | iterator end() { return iterator(scopes, scopes[0].end(), 0); } | 
|---|
| 211 | const_iterator end() const { return const_iterator(scopes, scopes[0].end(), 0); } | 
|---|
| 212 | const_iterator cend() const { return const_iterator(scopes, scopes[0].end(), 0); } | 
|---|
| 213 |  | 
|---|
| 214 | /// Gets the index of the current scope (counted from 1) | 
|---|
| 215 | size_type currentScope() const { return scopes.size(); } | 
|---|
| 216 |  | 
|---|
| 217 | /// Finds the given key in the outermost scope it occurs; returns end() for none such | 
|---|
| 218 | iterator find( const Key &key ) { | 
|---|
| 219 | for ( size_type i = scopes.size() - 1; ; --i ) { | 
|---|
| 220 | typename Scope::iterator val = scopes[i].find( key ); | 
|---|
| 221 | if ( val != scopes[i].end() ) return iterator( scopes, val, i ); | 
|---|
| 222 | if ( i == 0 ) break; | 
|---|
| 223 | } | 
|---|
| 224 | return end(); | 
|---|
| 225 | } | 
|---|
| 226 | const_iterator find( const Key &key ) const { | 
|---|
| 227 | return const_iterator( const_cast< ScopedMap< Key, Value >* >(this)->find( key ) ); | 
|---|
| 228 | } | 
|---|
| 229 |  | 
|---|
| 230 | /// Finds the given key in the outermost scope inside the given scope where it occurs | 
|---|
| 231 | iterator findNext( const_iterator &it, const Key &key ) { | 
|---|
| 232 | if ( it.i == 0 ) return end(); | 
|---|
| 233 | for ( size_type i = it.i - 1; ; --i ) { | 
|---|
| 234 | typename Scope::iterator val = scopes[i].find( key ); | 
|---|
| 235 | if ( val != scopes[i].end() ) return iterator( scopes, val, i ); | 
|---|
| 236 | if ( i == 0 ) break; | 
|---|
| 237 | } | 
|---|
| 238 | return end(); | 
|---|
| 239 | } | 
|---|
| 240 | const_iterator findNext( const_iterator &it, const Key &key ) const { | 
|---|
| 241 | return const_iterator( const_cast< ScopedMap< Key, Value >* >(this)->findNext( it, key ) ); | 
|---|
| 242 | } | 
|---|
| 243 |  | 
|---|
| 244 | /// Inserts the given key-value pair into the outermost scope | 
|---|
| 245 | std::pair< iterator, bool > insert( const value_type &value ) { | 
|---|
| 246 | std::pair< typename Scope::iterator, bool > res = scopes.back().insert( value ); | 
|---|
| 247 | return std::make_pair( iterator(scopes, res.first, scopes.size()-1), res.second ); | 
|---|
| 248 | } | 
|---|
| 249 | std::pair< iterator, bool > insert( const Key &key, const Value &value ) { return insert( std::make_pair( key, value ) ); } | 
|---|
| 250 |  | 
|---|
| 251 | Value& operator[] ( const Key &key ) { | 
|---|
| 252 | iterator slot = find( key ); | 
|---|
| 253 | if ( slot != end() ) return slot->second; | 
|---|
| 254 | return insert( key, Value() ).first->second; | 
|---|
| 255 | } | 
|---|
| 256 | }; | 
|---|
| 257 | } // namespace GenPoly | 
|---|
| 258 |  | 
|---|
| 259 | #endif // _SCOPEDMAP_H | 
|---|
| 260 |  | 
|---|
| 261 | // Local Variables: // | 
|---|
| 262 | // tab-width: 4 // | 
|---|
| 263 | // mode: c++ // | 
|---|
| 264 | // compile-command: "make install" // | 
|---|
| 265 | // End: // | 
|---|