Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

LastInVSet

Read the last variable-length data record in the set defined by target.

Short Name

LSTVSET()

Type

ISAM function

Declaration

COUNT LastInVSet(FILNO filno, pVOID target, pVOID recptr,

COUNT signlen, pVRLEN plen)

Description

In V12 the file number typedef was formally changed from COUNT, a two-byte value to FILNO, a four-byte value. Refer to this link for compatibility details. Four Byte File Numbering

LastInVSet() is identical to it’s fixed-length counterpart, LastInSet(), except that it reads the last variable-length data record in the set defined by target and siglen. If successful, this record becomes the current ISAM record for the associated data file.

plen acts as both an input and output parameter:

  • On input, plen contains the length of the output buffer.
  • On output, the contents of plen is the actual data-record length. If the length of the output buffer is less than the actual record length, a partial read is performed. If an error occurs, plen is unspecified.

Read the function description for LastInSet() for additional important information.

Return

Value

Symbolic Constant

Explanation

0

NO_ERROR

Successful retrieval of current ISAM record.

633

NPLN_ERR

plen is NULL.

634

NLEN_ERR

plen is negative on input.

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

See also

LastInSet(), NextInVSet(), PreviousInVSet(), TransformKey()

TOCIndex