Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cache.hpp « base - github.com/mapsme/omim.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: b792fd0333bd6e4af18dffb8388daf9e7bc13114 (plain)
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
#include "assert.hpp"
#include "base.hpp"
#include "../std/type_traits.hpp"
#include "../std/utility.hpp"
#include "../std/vector.hpp"

namespace my
{
  // Simple Cache that stores list of most recently used values.
  template <typename KeyT, typename ValueT> class Cache
  {
  private:
    Cache(Cache<KeyT, ValueT> const &);                             // Not implemented.
    Cache<KeyT, ValueT> & operator = (Cache<KeyT, ValueT> const &); // Not implemented.

  public:
    // Create cache with maximum size @maxCachedObjects.
    explicit Cache(uint32_t logCacheSize)
      : m_Cache(new Data[1 << logCacheSize]), m_HashMask((1 << logCacheSize) - 1)
    {
      STATIC_ASSERT((is_same<KeyT, uint32_t>::value ||
                     is_same<KeyT, uint64_t>::value));

      // We always use cache with static constant. So debug assert is enough here.
      ASSERT_GREATER ( logCacheSize, 0, () );
      ASSERT_GREATER ( m_HashMask, 0, () );
      ASSERT_LESS(logCacheSize, 32, ());

      Reset();
    }

    ~Cache()
    {
      delete [] m_Cache;
    }

    uint32_t GetCacheSize() const
    {
      return m_HashMask + 1;
    }

    // Find value by @key. If @key is found, returns reference to its value.
    // If @key is not found, some other key is removed and it's value is reused without
    // re-initialization. It's up to caller to re-initialize the new value if @found == false.
    // TODO: Return pair<ValueT *, bool> instead?
    ValueT & Find(KeyT const & key, bool & found)
    {
      Data & data = m_Cache[Index(key)];
      if (data.m_Key == key)
      {
        found = true;
      }
      else
      {
        found = false;
        data.m_Key = key;
      }
      return data.m_Value;
    }

    bool HasKey(KeyT const & key) const
    {
      Data const & data = m_Cache[Index(key)];
      return (data.m_Key == key);
    }

    template <typename F>
    void ForEachValue(F f)
    {
      for (uint32_t i = 0; i <= m_HashMask; ++i)
        f(m_Cache[i].m_Value);
    }

    void Reset()
    {
      // Initialize m_Cache such, that Index(m_Cache[i].m_Key) != i.
      for (uint32_t i = 0; i <= m_HashMask; ++i)
      {
        KeyT & key = m_Cache[i].m_Key;
        for (key = 0; Index(key) == i; ++key) ;
      }
    }

  private:
    inline size_t Index(KeyT const & key) const
    {
      return static_cast<size_t>(Hash(key) & m_HashMask);
    }

    inline static uint32_t Hash(uint32_t x)
    {
      x = (x ^ 61) ^ (x >> 16);
      x = x + (x << 3);
      x = x ^ (x >> 4);
      x = x * 0x27d4eb2d;
      x = x ^ (x >> 15);
      return x;
    }
    inline static uint32_t Hash(uint64_t x)
    {
      return Hash(uint32_t(x) ^ uint32_t(x >> 32));
    }

    // TODO: Consider using separate arrays for keys and values, to save on padding.
    struct Data
    {
      Data() : m_Key(), m_Value() {}
      KeyT m_Key;
      ValueT m_Value;
    };

    Data * const m_Cache;
    uint32_t const m_HashMask;
  };
}