class BitReader

Initialize the reader to start reading at `data`, `size` being size

of `data` in bytes.

DEPRECATED: Use the above `base::span` variant to avoid unsafe buffer

usage.

TODO(https://crbug.com/40284755): Remove this once the callers are gone.

Read one bit from the stream and return it as a boolean in `*flag`.

Read `num_bits` of binary data into `str`. `num_bits` must be a positive

multiple of 8. This is not efficient for extracting large strings.

If false is returned, `str` may not be valid.

Read binary data into `out`. This is not efficient for extracting large

data.

If false is returned, `out` may not be valid.

Read `num_bits` next bits from stream and return in `*out`, first bit

from the stream starting at `num_bits` position in `*out`,

bits of `*out` whose position is strictly greater than `num_bits`

are all set to zero.

Notes:

- `num_bits` cannot be larger than the bits the type can hold.

- From the above description, passing a signed type in `T` does not

mean the first bit read from the stream gives the sign of the value.

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.

Read one bit from the stream and return it as a boolean in `*out`.

Remark: we do not use the template version for reading a bool

since it generates some optimization warnings during compilation

on Windows platforms.

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/ReadFlag/SkipBits operations will always return false unless

`num_bits` is 0.

Returns the number of bits read so far.