src/net/disk_cache/bitmap.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef NET_DISK_CACHE_BITMAP_H_
   6 #define NET_DISK_CACHE_BITMAP_H_
   7
   8 #include "base/basictypes.h"
   9 #include "net/base/net_export.h"
  10
  11 namespace disk_cache {
  12
  13 // This class provides support for simple maps of bits.
  14 class NET_EXPORT_PRIVATE Bitmap {
  15  public:
  16   Bitmap() : map_(NULL), num_bits_(0), array_size_(0), alloc_(false) {}
  17
  18   // This constructor will allocate on a uint32 boundary. If |clear_bits| is
  19   // false, the bitmap bits will not be initialized.
  20   Bitmap(int num_bits, bool clear_bits);
  21
  22   // Constructs a Bitmap with the actual storage provided by the caller. |map|
  23   // has to be valid until this object destruction. |num_bits| is the number of
  24   // bits in the bitmap, and |num_words| is the size of |map| in 32-bit words.
  25   Bitmap(uint32* map, int num_bits, int num_words);
  26
  27   ~Bitmap();
  28
  29   // Resizes the bitmap.
  30   // If |num_bits| < Size(), the extra bits will be discarded.
  31   // If |num_bits| > Size(), the extra bits will be filled with zeros if
  32   // |clear_bits| is true.
  33   // This object cannot be using memory provided during construction.
  34   void Resize(int num_bits, bool clear_bits);
  35
  36   // Returns the number of bits in the bitmap.
  37   int Size() const { return num_bits_; }
  38
  39   // Returns the number of 32-bit words in the bitmap.
  40   int ArraySize() const { return array_size_; }
  41
  42   // Sets all the bits to true or false.
  43   void SetAll(bool value) {
  44     memset(map_, (value ? 0xFF : 0x00), array_size_ * sizeof(*map_));
  45   }
  46
  47   // Clears all bits in the bitmap
  48   void Clear() { SetAll(false); }
  49
  50   // Sets the value, gets the value or toggles the value of a given bit.
  51   void Set(int index, bool value);
  52   bool Get(int index) const;
  53   void Toggle(int index);
  54
  55   // Directly sets an element of the internal map. Requires |array_index| <
  56   // ArraySize();
  57   void SetMapElement(int array_index, uint32 value);
  58
  59   // Gets an entry of the internal map. Requires array_index <
  60   // ArraySize()
  61   uint32 GetMapElement(int array_index) const;
  62
  63   // Directly sets the whole internal map. |size| is the number of 32-bit words
  64   // to set from |map|. If  |size| > array_size(), it ignores the end of |map|.
  65   void SetMap(const uint32* map, int size);
  66
  67   // Gets a pointer to the internal map.
  68   const uint32* GetMap() const { return map_; }
  69
  70   // Sets a range of bits to |value|.
  71   void SetRange(int begin, int end, bool value);
  72
  73   // Returns true if any bit between begin inclusive and end exclusive is set.
  74   // 0 <= |begin| <= |end| <= Size() is required.
  75   bool TestRange(int begin, int end, bool value) const;
  76
  77   // Scans bits starting at bit *|index|, looking for a bit set to |value|. If
  78   // it finds that bit before reaching bit index |limit|, sets *|index| to the
  79   // bit index and returns true. Otherwise returns false.
  80   // Requires |limit| <= Size().
  81   //
  82   // Note that to use these methods in a loop you must increment the index
  83   // after each use, as in:
  84   //
  85   //  for (int index = 0 ; map.FindNextBit(&index, limit, value) ; ++index) {
  86   //    DoSomethingWith(index);
  87   //  }
  88   bool FindNextBit(int* index, int limit, bool value) const;
  89
  90   // Finds the first offset >= *|index| and < |limit| that has its bit set.
  91   // See FindNextBit() for more info.
  92   bool FindNextSetBitBeforeLimit(int* index, int limit) const {
  93     return FindNextBit(index, limit, true);
  94   }
  95
  96   // Finds the first offset >= *|index| that has its bit set.
  97   // See FindNextBit() for more info.
  98   bool FindNextSetBit(int *index) const {
  99     return FindNextSetBitBeforeLimit(index, num_bits_);
 100   }
 101
 102   // Scans bits starting at bit *|index|, looking for a bit set to |value|. If
 103   // it finds that bit before reaching bit index |limit|, sets *|index| to the
 104   // bit index and then counts the number of consecutive bits set to |value|
 105   // (before reaching |limit|), and returns that count. If no bit is found
 106   // returns 0. Requires |limit| <= Size().
 107   int FindBits(int* index, int limit, bool value) const;
 108
 109   // Returns number of allocated words required for a bitmap of size |num_bits|.
 110   static int RequiredArraySize(int num_bits) {
 111     // Force at least one allocated word.
 112     if (num_bits <= kIntBits)
 113       return 1;
 114
 115     return (num_bits + kIntBits - 1) >> kLogIntBits;
 116   }
 117
 118  private:
 119   static const int kIntBits = sizeof(uint32) * 8;
 120   static const int kLogIntBits = 5;  // 2^5 == 32 bits per word.
 121
 122   // Sets |len| bits from |start| to |value|. All the bits to be set should be
 123   // stored in the same word, and len < kIntBits.
 124   void SetWordBits(int start, int len, bool value);
 125
 126   uint32* map_;           // The bitmap.
 127   int num_bits_;          // The upper bound of the bitmap.
 128   int array_size_;        // The physical size (in uint32s) of the bitmap.
 129   bool alloc_;            // Whether or not we allocated the memory.
 130
 131   DISALLOW_COPY_AND_ASSIGN(Bitmap);
 132 };
 133
 134 }  // namespace disk_cache
 135
 136 #endif  // NET_DISK_CACHE_BITMAP_H_