SplitStreamContainer

Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject, com.aspose.imaging.StreamContainer

public class SplitStreamContainer extends StreamContainer

Represents split stream container which contains the stream and provides stream processing routines.

Constructors

ConstructorDescription
SplitStreamContainer(InputStream stream)Initializes a new instance of the SplitStreamContainer class.
SplitStreamContainer(InputStream stream, boolean disposeStream)Initializes a new instance of the SplitStreamContainer class.
SplitStreamContainer(StreamContainer stream, boolean disposeStream)Initializes a new instance of the SplitStreamContainer class.

Methods

MethodDescription
getSyncRoot()Gets an object that can be used to synchronize access to the synchronized resource.
getPosition()Gets the current position within the stream.
setPosition(long value)Sets the current position within the stream.
getLength()Gets the stream length in bytes.
setLength(long value)Sets the stream length in bytes.
canRead()Gets a value indicating whether stream supports reading.
canSeek()Gets a value indicating whether stream supports seeking.
canWrite()Gets a value indicating whether stream supports writing.
insert(int position, StreamContainer stream, boolean disposeStream)Inserts the stream container into specified position.
flush()Clears all buffers for this stream and causes any buffered data to be written to the underlying device.
write(byte[] bytes)Writes all of the specified bytes to the stream.
writeByte(byte value)Writes a byte to the current position in the stream and advances the position within the stream by one byte.
read(byte[] bytes)Reads bytes to fill the specified bytes buffer.
toBytes()Converts the stream data to the byte array.
toBytes(long position, long bytesCount)Converts the stream data to the byte array.
read(byte[] buffer, int offset, int count)Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.
readByte()Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.
seek(long offset, int origin)Sets the position within the current stream.
seekBegin()Sets the stream position to the beginning of the stream.
write(byte[] buffer, int offset, int count)Writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

SplitStreamContainer(InputStream stream)

public SplitStreamContainer(InputStream stream)

Initializes a new instance of the SplitStreamContainer class.

Parameters:

ParameterTypeDescription
streamjava.io.InputStreamThe stream.

SplitStreamContainer(InputStream stream, boolean disposeStream)

public SplitStreamContainer(InputStream stream, boolean disposeStream)

Initializes a new instance of the SplitStreamContainer class.

Parameters:

ParameterTypeDescription
streamjava.io.InputStreamThe data stream.
disposeStreambooleanif set to true the stream will be disposed when container is disposed.

SplitStreamContainer(StreamContainer stream, boolean disposeStream)

public SplitStreamContainer(StreamContainer stream, boolean disposeStream)

Initializes a new instance of the SplitStreamContainer class.

Parameters:

ParameterTypeDescription
streamStreamContainerThe stream container.
disposeStreambooleanif set to true disposes stream.

getSyncRoot()

public Object getSyncRoot()

Gets an object that can be used to synchronize access to the synchronized resource.

Returns: java.lang.Object - The object that can be used to synchronize access to the synchronized resource.

getPosition()

public long getPosition()

Gets the current position within the stream. This value represents offset from the starting stream position passed in the StreamContainer constructor.

Returns: long - The current stream position.

setPosition(long value)

public void setPosition(long value)

Sets the current position within the stream. This value represents offset from the starting stream position passed in the StreamContainer constructor.

Parameters:

ParameterTypeDescription
valuelongThe current stream position.

getLength()

public long getLength()

Gets the stream length in bytes. This value is less than the System.IO.Stream.Length by the starting stream position passed in the StreamContainer constructor.

Returns: long - The stream length.

setLength(long value)

public void setLength(long value)

Sets the stream length in bytes. This value is less than the System.IO.Stream.Length by the starting stream position passed in the StreamContainer constructor.

Parameters:

ParameterTypeDescription
valuelongThe stream length.

canRead()

public boolean canRead()

Gets a value indicating whether stream supports reading.

Returns: boolean - true if stream supports reading; otherwise, false.

canSeek()

public boolean canSeek()

Gets a value indicating whether stream supports seeking.

Returns: boolean - true if stream supports seeking; otherwise, false.

canWrite()

public boolean canWrite()

Gets a value indicating whether stream supports writing.

Returns: boolean - true if stream supports writing; otherwise, false.

insert(int position, StreamContainer stream, boolean disposeStream)

public void insert(int position, StreamContainer stream, boolean disposeStream)

Inserts the stream container into specified position.

Parameters:

ParameterTypeDescription
positionintThe position to insert to.
streamStreamContainerThe stream container to insert.
disposeStreambooleanif set to true disposes stream.

flush()

public void flush()

Clears all buffers for this stream and causes any buffered data to be written to the underlying device.

write(byte[] bytes)

public void write(byte[] bytes)

Writes all of the specified bytes to the stream.

Parameters:

ParameterTypeDescription
bytesbyte[]The bytes to write.

writeByte(byte value)

public void writeByte(byte value)

Writes a byte to the current position in the stream and advances the position within the stream by one byte.

Parameters:

ParameterTypeDescription
valuebyteThe byte to write to the stream.

read(byte[] bytes)

public int read(byte[] bytes)

Reads bytes to fill the specified bytes buffer.

Parameters:

ParameterTypeDescription
bytesbyte[]The bytes to fill.

Returns: int - The number of bytes read. This value can be less than the number of bytes in the buffer if there is not enough bytes in the stream.

toBytes()

public byte[] toBytes()

Converts the stream data to the byte array.

Returns: byte[] - The stream data converted to the byte array.

toBytes(long position, long bytesCount)

public byte[] toBytes(long position, long bytesCount)

Converts the stream data to the byte array.

Parameters:

ParameterTypeDescription
positionlongThe position to start reading bytes from.
bytesCountlongThe bytes count to read.

Returns: byte[] - The stream data converted to the byte array.

read(byte[] buffer, int offset, int count)

public int read(byte[] buffer, int offset, int count)

Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

Parameters:

ParameterTypeDescription
bufferbyte[]An array of bytes. When this method returns, the buffer contains the specified byte array with the values between offset and (offset + count - 1) replaced by the bytes read from the current source.
offsetintThe zero-based byte offset in buffer at which to begin storing the data read from the current stream.
countintThe maximum number of bytes to be read from the current stream.

Returns: int - The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero (0) if the end of the stream has been reached.

readByte()

public int readByte()

Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.

Returns: int - The unsigned byte cast to an Int32, or -1 if at the end of the stream.

seek(long offset, int origin)

public long seek(long offset, int origin)

Sets the position within the current stream.

Parameters:

ParameterTypeDescription
offsetlongA byte offset relative to the origin parameter. This value represents offset from the starting stream position passed in the StreamContainer constructor.
originintA value of type System.IO.SeekOrigin indicating the reference point used to obtain the new position.

Returns: long - The new position within the current stream.

seekBegin()

public void seekBegin()

Sets the stream position to the beginning of the stream. This value represents offset from the starting stream position passed in the StreamContainer constructor.

write(byte[] buffer, int offset, int count)

public void write(byte[] buffer, int offset, int count)

Writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Parameters:

ParameterTypeDescription
bufferbyte[]An array of bytes. This method copies count bytes from buffer to the current stream.
offsetintThe zero-based byte offset in buffer at which to begin copying bytes to the current stream.
countintThe number of bytes to be written to the current stream.