public class CarbonCopyStream extends SeekableInputStream
ByteArrayBuffer
. This copying does not at all consider
seeking, i.e. reading the same source stream segment twice using seeks will yield a buffer
holding two copies of this segment.bitOffset, byteOrder, flushedPos
Constructor and Description |
---|
CarbonCopyStream(SeekableInputStream source)
Create a CarbonCopyStream that proxies the a part of the source stream starting at current
stream position of the source stream.
|
CarbonCopyStream(SeekableInputStream source,
long start)
Create a CarbonCopyStream that proxies the a part of the source stream starting at the given
start position.
|
Modifier and Type | Method and Description |
---|---|
ByteArrayBuffer |
getBuffer()
Return the
ByteArrayBuffer holding a copy of the data read via this stream. |
long |
getSizeEstimate()
A rough estimated size for this stream instance, which is used for internal cache management.
|
long |
getStreamPosition() |
long |
length()
Returns the length of this stream contents, if available.
|
int |
read()
Reads a single byte from the stream and returns it as an
int between 0 and 255. |
int |
read(byte[] b,
int off,
int len)
Reads up to
len bytes from the stream, and stores them into b
starting at index off . |
void |
seek(long pos)
Sets the current stream position, measured from the beginning of this data stream, at which the
next read occurs.
|
checkClosed, close, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, isCached, isCachedFile, isCachedMemory, mark, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedInt, readUnsignedShort, readUTF, reset, resetToInitialState, setBitOffset, setByteOrder, skip, skipBytes, skipBytes
available, markSupported
public CarbonCopyStream(SeekableInputStream source) throws IOException
IOException
public CarbonCopyStream(SeekableInputStream source, long start) throws IOException
seek(long)
and getStreamPosition()
will take this start
offset in consideration, i.e. seeking the CarbonCopyStream to offset 0 (zero) will seek the
source stream to the given start position.IOException
public long getStreamPosition() throws IOException
IOException
public void seek(long pos) throws IOException
SeekableInputStream
EOFException
will be thrown
only if a read is performed. The bit offset is set to 0.
An IndexOutOfBoundsException
will be thrown if pos
is smaller than
the flushed position (as returned by getflushedPosition
).
It is legal to seek past the end of the file; an EOFException
will be thrown only
if a read is performed.
seek
in interface ImageInputStream
seek
in class SeekableInputStream
pos
- a long
containing the desired file pointer position.IOException
- if any other I/O error occurs.public long length() throws IOException
SeekableInputStream
length
in interface ImageInputStream
length
in class SeekableInputStream
IOException
- if an I/O error occurs.public int read() throws IOException
SeekableInputStream
int
between 0 and 255. If
EOF is reached, -1
is returned.
Subclasses must provide an implementation for this method. The subclass implementation should update the stream position before exiting.
The bit offset within the stream must be reset to zero before the read occurs.
read
in interface ImageInputStream
read
in class SeekableInputStream
-1
if EOF is reached.IOException
- if the stream has been closed.public int read(byte[] b, int off, int len) throws IOException
SeekableInputStream
len
bytes from the stream, and stores them into b
starting at index off
. If no bytes can be read because the end of the stream has
been reached, -1
is returned.
The bit offset within the stream must be reset to zero before the read occurs.
Subclasses must provide an implementation for this method. The subclass implementation should update the stream position before exiting.
read
in interface ImageInputStream
read
in class SeekableInputStream
b
- an array of bytes to be written to.off
- the starting position within b
to write to.len
- the maximum number of bytes to read.-1
to indicate EOF.IOException
- if an I/O error occurs.public long getSizeEstimate()
SeekableInputStream
getSizeEstimate
in class SeekableInputStream
public ByteArrayBuffer getBuffer()
ByteArrayBuffer
holding a copy of the data read via this stream.ByteArrayBuffer
Copyright © 2024 levigo holding gmbh. All rights reserved.