RangeMap

comp

id_iterator

Macros

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221
#ifndef DataFormats_Common_RangeMap_h
#define DataFormats_Common_RangeMap_h
/* \class edm::RangeMap
 *
 * Generic container storing objects arranged according 
 * to a specified identifier. 
 *
 * The data content can be fetched either via
 * an iterator, or specifying user-defined identifier 
 * match criteria.
 *
 * The template parameters are:
 * - ID: identifier type
 * - C : underlying collection used to 
 * - P : policy to perform object cloning
 *
 * \author Tommaso Boccali, Luca Lista INFN
 *
 *
 */
#include <map>
#include <vector>
#include <functional>
#include "DataFormats/Common/interface/CMS_CLASS_VERSION.h"
#include "FWCore/Utilities/interface/Exception.h"
#include "DataFormats/Common/interface/traits.h"
#include "DataFormats/Common/interface/CloneTrait.h"

namespace edm {

  template <typename ID, typename C, typename P = typename clonehelper::CloneTrait<C>::type>
  class RangeMap {
  public:
    /// contained object type
    typedef typename C::value_type value_type;
    /// collection size type
    typedef typename C::size_type size_type;
    /// reference type
    typedef typename C::reference reference;
    /// pointer type
    typedef typename C::pointer pointer;
    /// constant access iterator type
    typedef typename C::const_iterator const_iterator;
    /// index range
    //use unsigned int rather than C::size_type in order to avoid porting problems
    typedef std::pair<unsigned int, unsigned int> pairType;
    /// map of identifier to index range
    typedef std::map<ID, pairType> mapType;
    /// iterator range
    typedef std::pair<const_iterator, const_iterator> range;

  private:
    /// comparator helper class
    template <typename CMP>
    struct comp {
      comp(const CMP c) : cmp(c) {}
      bool operator()(ID id, const typename mapType::value_type& p) { return cmp(id, p.first); }
      bool operator()(const typename mapType::value_type& p, ID id) { return cmp(p.first, id); }

    private:
      CMP cmp;
    };

  public:
    /// default constructor
    RangeMap() {}
    /// get range of objects matching a specified identifier with a specified comparator.
    /// <b>WARNING</b>: the comparator has to be written
    /// in such a way that the std::equal_range
    /// function returns a meaningful range.
    /// Not properly written comparators may return
    /// an unpredictable range. It is recommended
    /// to use only comparators provided with CMSSW release.
    template <typename CMP>
    range get(ID id, CMP comparator) const {
      std::pair<typename mapType::const_iterator, typename mapType::const_iterator> r =
          std::equal_range(map_.begin(), map_.end(), id, comp<CMP>(comparator));
      const_iterator begin, end;
      if ((r.first) == map_.end()) {
        begin = end = collection_.end();
        return std::make_pair(begin, end);
      } else {
        begin = collection_.begin() + (r.first)->second.first;
      }
      if ((r.second) == map_.end()) {
        end = collection_.end();
      } else {
        end = collection_.begin() + (r.second)->second.first;
      }
      return std::make_pair(begin, end);
    }
    /// get range of objects matching a specified identifier with a specified comparator.
    template <typename CMP>
    range get(std::pair<ID, CMP> p) const {
      return get(p.first, p.second);
    }
    /// get a range of objects with specified identifier
    range get(ID id) const {
      const_iterator begin, end;
      typename mapType::const_iterator i = map_.find(id);
      if (i != map_.end()) {
        begin = collection_.begin() + i->second.first;
        end = collection_.begin() + i->second.second;
      } else {
        begin = end = collection_.end();
      }
      return std::make_pair(begin, end);
    }
    /// insert an object range with specified identifier
    template <typename CI>
    void put(ID id, CI begin, CI end) {
      typename mapType::const_iterator i = map_.find(id);
      if (i != map_.end()) {
        throw Exception(errors::LogicError, "trying to insert duplicate entry");
      }
      assert(i == map_.end());
      pairType& p = map_[id];
      p.first = collection_.size();
      for (CI ii = begin; ii != end; ++ii)
        collection_.push_back(P::clone(*ii));
      p.second = collection_.size();
    }
    /// return number of contained object
    size_t size() const { return collection_.size(); }
    /// first collection iterator
    typename C::const_iterator begin() const { return collection_.begin(); }
    /// last collection iterator
    typename C::const_iterator end() const { return collection_.end(); }
    /// identifier iterator
    struct id_iterator {
      typedef ID value_type;
      typedef ID* pointer;
      typedef ID& reference;
      typedef ptrdiff_t difference_type;
      typedef typename mapType::const_iterator::iterator_category iterator_category;
      typedef typename mapType::const_iterator const_iterator;
      id_iterator() {}
      id_iterator(const_iterator o) : i(o) {}
      id_iterator& operator++() {
        ++i;
        return *this;
      }
      id_iterator operator++(int) {
        id_iterator ci = *this;
        ++i;
        return ci;
      }
      id_iterator& operator--() {
        --i;
        return *this;
      }
      id_iterator operator--(int) {
        id_iterator ci = *this;
        --i;
        return ci;
      }
      bool operator==(const id_iterator& ci) const { return i == ci.i; }
      bool operator!=(const id_iterator& ci) const { return i != ci.i; }
      const ID operator*() const { return i->first; }

    private:
      const_iterator i;
    };
    /// perfor post insert action
    void post_insert() {
      // sorts the container via ID
      C tmp;
      for (typename mapType::iterator it = map_.begin(), itEnd = map_.end(); it != itEnd; it++) {
        range r = get((*it).first);
        //do cast to acknowledge that we may be going from a larger type to a smaller type but we are OK
        unsigned int begIt = static_cast<unsigned int>(tmp.size());
        for (const_iterator i = r.first; i != r.second; ++i)
          tmp.push_back(P::clone(*i));
        unsigned int endIt = static_cast<unsigned int>(tmp.size());
        it->second = pairType(begIt, endIt);
      }
      collection_ = tmp;
    }
    /// first identifier iterator
    id_iterator id_begin() const { return id_iterator(map_.begin()); }
    /// last identifier iterator
    id_iterator id_end() const { return id_iterator(map_.end()); }
    /// number of contained identifiers
    size_t id_size() const { return map_.size(); }
    /// indentifier vector
    std::vector<ID> ids() const {
      std::vector<ID> temp(id_size());
      std::copy(id_begin(), id_end(), temp.begin());
      return temp;
    }
    /// direct access to an object in the collection
    reference operator[](size_type i) { return collection_[i]; }

    /// swap member function
    void swap(RangeMap<ID, C, P>& other);

    //Used by ROOT storage
    CMS_CLASS_VERSION(10)

  private:
    /// stored collection
    C collection_;
    /// identifier map
    mapType map_;
  };

  template <typename ID, typename C, typename P>
  inline void RangeMap<ID, C, P>::swap(RangeMap<ID, C, P>& other) {
    collection_.swap(other.collection_);
    map_.swap(other.map_);
  }

  // free swap function
  template <typename ID, typename C, typename P>
  inline void swap(RangeMap<ID, C, P>& a, RangeMap<ID, C, P>& b) {
    a.swap(b);
  }

}  // namespace edm

#endif