PreviousInRange

Read the previous record in a range

Short Name

PRVRNG()

Type

ISAM function

Declaration

COUNT PreviousInRange(COUNT keyval, pVOID recptr)

Description

Read the previous data record in a range established by a call to AllocateRange(). If successful, the record becomes the current ISAM record for the associated data file. A successful PreviousInRange() defines a current key value set, and subsequent calls to NextInRange() or PreviousInRange() will read the other records in the range.

If the data file has variable-length records, only the fixed-length portion of the record is actually read. You can use ReReadVRecord() to retrieve the whole record, including the variable length portion. You can use PreviousInVRange() to read the whole variable length record with one function call.

Return

Value

Symbolic Constant

Explanation

NO_ERROR

Successful operation.

101

INOT_ERR

Could not satisfy and ISAM search request for index isam_fil. This error frequently indicates "End of File" reached, or "Record not Found."

The following 4 items are the probable causes of the INOT_ERR (101).

Passing GetRecord() a duplicate allowed index number (keyno). GetRecord() does not support duplicate allowed indices.
Improper target padding. Review “Key Segment Modes” in the c-tree Plus Programmer’s Guide.
Not calling TransformKey() on target. Refer to “TransformKey” in the Function Reference Guide
Improper segment mode. Review “Key Segment Modes” in the c-tree Plus Programmer’s Guide.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.