Interface BitInputStream
- All Superinterfaces:
AutoCloseable
,Closeable
- All Known Implementing Classes:
ByteBitInputStream
A stream of bits that can be read. Bits are packed in little endian within a
byte. For example, the byte 0x87 reads as the sequence of bits
[1,1,1,0,0,0,0,1].
-
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Closes this stream and the underlying input stream.int
Returns the current bit position, which ascends from 0 to 7 as bits are read.int
read()
Reads a bit from this stream.int
readByte()
Discards the remainder of the current byte (if any) and reads the next whole byte from the stream.int
Reads a bit from this stream.
-
Method Details
-
getBitPosition
int getBitPosition()Returns the current bit position, which ascends from 0 to 7 as bits are read.- Returns:
- the current bit position, which is between 0 and 7
-
readByte
Discards the remainder of the current byte (if any) and reads the next whole byte from the stream. Returns -1 if the end of stream is reached.- Returns:
- the next byte from the stream, or -1 if the end of stream is reached
- Throws:
IOException
-
read
Reads a bit from this stream. Returns 0 or 1 if a bit is available, or -1 if the end of stream is reached. The end of stream always occurs on a byte boundary.- Returns:
- the next bit of 0 or 1, or -1 for the end of stream
- Throws:
IOException
- if an I/O exception occurred
-
readNoEof
Reads a bit from this stream. Returns 0 or 1 if a bit is available, or throws anEOFException
if the end of stream is reached. The end of stream always occurs on a byte boundary.- Returns:
- the next bit of 0 or 1
- Throws:
IOException
- if an I/O exception occurredEOFException
- if the end of stream is reached
-
close
Closes this stream and the underlying input stream.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Throws:
IOException
- if an I/O exception occurred
-