readFromSource(byte[ ] [ ], int, int, byte[ ] [ ])

Format

public int readFromSource(byte[ ] [ ] ctx, int startpos, int numbytes, byte[ ] [ ] buffer)

Description

Reads data from the data source. This method reads the specified number of bytes into the application buffer from the data source, starting at the specified position in the data source.

Not all source plug-ins require that the data source be opened before it can be read. However, to ensure that an application will work with any current or future source plug-ins, call the openSource(byte[ ], byte[ ] [ ]) method before calling this method.

Parameters

ctx

The source plug-in context information. See Oracle interMedia Reference for more information.

startpos

The start position in the data source.

numbytes

The number of bytes to be read from the data source.

buffer

A byte array of the form [1][n], where n is greater than or equal to numbytes.

Return Value

This method returns the number of bytes read, as an integer.

Exceptions

java.sql.SQLException

This exception is thrown if an error occurs executing the corresponding readFromSource( ) method in the database.

Examples

None.