trimSource(byte[ ] [ ], int)

Format

public int trimSource(byte[ ] [ ] ctx, int newLen)

Description

Trims the data to the specified length.

Not all source plug-ins support trim operations. For example, applications can trim the data stored in a BLOB specified by the localData attribute; however, the "file" and "http" data source types do not support write access, and so do not support this method. Furthermore, those source plug-ins that do support write access may not support the trim operation.

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

Parameters

ctx

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

newLen

The length to which the data is to be trimmed.

Return Value

This method returns the status as an integer, where zero indicates success and a non-zero value indicates a failure code specific to the source plug-in.

Exceptions

java.sql.SQLException

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

Examples

None.