int pblIsamFind

( pblIsamFile_t* isamfile, int which,
  int index, void* skey, size_t skeylen,
  void* okey )

find a record in an ISAM file, set the current record

Documentation

find a record in an ISAM file, set the current record

parameter which specifies which record to find relative to the search key specified by skey and skeylen. the following values for which are possible

PBLEQ - find a record whose key is equal to skey
PBLFI - find the first record that is equal
PBLLA - find the last record that is equal
PBLGE - find the last record that is equal or the smallest record that is greater
PBLGT - find the smallest record that is greater
PBLLE - find the first record that is equal or the biggest record that is smaller
PBLLT - find the biggest record that is smaller

parameter index specifies which of the keys to use

RESTRICTIONS:
- the out parameter okey must point to a memory area that is big enough to hold any possible key, i.e 255 bytes

Parameters:

isamfile - ISAM file to search in
which - mode to use for search
index - index of key to use for search
skey - key to use for search
skeylen - length of search key
okey - buffer for result key

Returns:

int rc >= 0:

• call went OK, the value returned is the length of the key of the record found,
• the key of the record is copied to okey,
• the current record of the file is set to the record found

int rc < 0:

• some error occurred, see pbl_errno especially PBL_ERROR_NOT_FOUND, if there is no matching record

Alphabetic index