Split the bit reader functionalities from the byte stream provider.

media/base/bit_reader.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef MEDIA_BASE_BIT_READER_H_
 #define MEDIA_BASE_BIT_READER_H_
 
 #include <sys/types.h>
 
 #include "base/basictypes.h"
-#include "base/logging.h"
+#include "base/memory/scoped_ptr.h"
+#include "media/base/bit_reader_core.h"
 #include "media/base/media_export.h"
 
 namespace media {
 
-// A class to read bit streams.
 class MEDIA_EXPORT BitReader {
  public:
   // Initialize the reader to start reading at |data|, |size| being size
   // of |data| in bytes.
   BitReader(const uint8* data, off_t size);
   ~BitReader();
 
-  // Read |num_bits| next bits from stream and return in |*out|, first bit
-  // from the stream starting at |num_bits| position in |*out|.
-  // |num_bits| cannot be larger than the bits the type can hold.
-  // Return false if the given number of bits cannot be read (not enough
-  // bits in the stream), true otherwise. When return false, the stream will
-  // enter a state where further ReadBits/SkipBits operations will always
-  // return false unless |num_bits| is 0. The type |T| has to be a primitive
-  // integer type.
   template<typename T> bool ReadBits(int num_bits, T *out) {
-    DCHECK_LE(num_bits, static_cast<int>(sizeof(T) * 8));
-    uint64 temp;
-    bool ret = ReadBitsInternal(num_bits, &temp);
-    *out = static_cast<T>(temp);
-    return ret;
+    return bit_reader_core_.ReadBits(num_bits, out);
   }
 
-  // Skip |num_bits| next bits from stream. Return false if the given number of
-  // bits cannot be skipped (not enough bits in the stream), true otherwise.
-  // When return false, the stream will enter a state where further ReadBits/
-  // SkipBits operations will always return false unless |num_bits| is 0.
-  bool SkipBits(int num_bits);
+  bool ReadFlag(bool* flag) {

[acolwell GONE FROM CHROMIUM, 2013/12/28 01:54:42]

Why is this being added? It doesn't appear to be used by anything. Please defer
adding this until actual usage appears.

[damienv1, 2013/12/28 02:26:17]

If we don't expose ReadFlag, all the parsers will continue to use ReadBits with
an int to read flags... (vicious circle).
I can add some unittests to exercise ReadFlag.

[acolwell GONE FROM CHROMIUM, 2014/01/06 22:44:06]

I understand. I'd prefer you add it in a follow-up CL where you replace some of
those int flag readers w/ ReadFlag() calls. That way we make sure production
code is using this functionality.

+    return bit_reader_core_.ReadFlag(flag);
+  }
+
+  bool SkipBits(int num_bits) {
+    return bit_reader_core_.SkipBits(num_bits);
+  }
 
   // Returns the number of bits available for reading.
-  int bits_available() const;
+  int bits_available() const {
+    return bit_reader_core_.bits_available();
+  }
+
+  int GetBitCount() {

[acolwell GONE FROM CHROMIUM, 2013/12/28 01:54:42]

ditto

[damienv1, 2013/12/28 02:26:17]

GetBitCount will remove the need of both:
- NumEmulationPreventionBytesRead
- and NumBitsLeft
which are only used in the following piece of code:
https://code.google.com/p/chromium/codesearch#chromium/src/content/common/gpu...

[acolwell GONE FROM CHROMIUM, 2014/01/06 22:44:06]

Ok, but I'd prefer you defer the addition of the method until you actually
replace that functionality.

+    return bit_reader_core_.GetBitCount();
+  }
 
  private:
-  // Help function used by ReadBits to avoid inlining the bit reading logic.
-  bool ReadBitsInternal(int num_bits, uint64* out);
+  scoped_ptr<BitReaderCore::ByteStreamProvider> byte_stream_provider_;
 
-  // Advance to the next byte, loading it into curr_byte_.
-  // If the num_remaining_bits_in_curr_byte_ is 0 after this function returns,
-  // the stream has reached the end.
-  void UpdateCurrByte();
+  BitReaderCore bit_reader_core_;
 
-  // Pointer to the next unread (not in curr_byte_) byte in the stream.
-  const uint8* data_;
-
-  // Bytes left in the stream (without the curr_byte_).
-  off_t bytes_left_;
-
-  // Contents of the current byte; first unread bit starting at position
-  // 8 - num_remaining_bits_in_curr_byte_ from MSB.
-  uint8 curr_byte_;
-
-  // Number of bits remaining in curr_byte_
-  int num_remaining_bits_in_curr_byte_;
-
- private:
   DISALLOW_COPY_AND_ASSIGN(BitReader);
 };
 
 }  // namespace media
 
 #endif  // MEDIA_BASE_BIT_READER_H_