GetChunk Method

See Also

Example

Applies To

OraField

Description

Returns a string containing the bytes of all or a portion of a long or long raw field.

Usage

data_string = orafield.GetChunk( offset, numbytes)

data_string = orafield.DbGetChunk( offset, numbytes)

Arguments

offset	The number of bytes of the field to skip before copying data
numbytes	The number of bytes to copy

Remarks

GetChunk typically retrieves the specified bytes from the local cache. If data is not found in the cache then GetChunk requests it from the database. Data from all fields (except the Long or Long Raw field) in the dynaset are retrieved and compared with the cached values for consistency. If any changes have occurred since the last fetch then GetChunk aborts the operation with an error and returns a NULL string.

If a long or long raw field is less than 64KB in size, it is quicker to retrieve the data using the Value property than using GetChunk. You cannot use GetChunk on a long or long raw field that you have aliased.

See Migration from Long Raw to LOB/BFILE for additional information.