read

Reads a chunk of data from the stream.

Reads and returns the specified number of bytes, or fewer if the end of stream is reached. Throws a StreamNotOpenException if the stream is not open for reading.

Syntax

public byte[] read(long length)

Parameters

length – The maximum number of bytes to be read into the chunk.

Returns

read returns a chunk of binary data read from the stream, or a null value if the end of the stream has been reached.

Examples

Read – Reads in a binary book image.

Book book = Book.findByPrimaryKey(bookID);
com.sybase.persistence.BigBinary image = book.getCover();
int bufferLength = 1024;
image.openForRead();
byte[] binary = image.read(bufferLength);
while (binary != null)
{
    binary = image.read(bufferLength);
}
image.close();