long pblKfGetAbs

( pblKeyFile_t* k, long absindex, void* okey,
  size_t* okeylen )

Set the current record to a record with an absolute position index.

Documentation

Set the current record to a record with an absolute position index.

This function is only to be used through the macro functions:

pblKfFirst( k, okey, okeylen ) read key of first record
pblKfLast( k, okey, okeylen ) read key of last record

Parameters:

k - key file to position in
absindex - index of record to positon to
okey - buffer for result key
okeylen - length of the result key after return

Returns:

long rc >= 0:

• call went ok, the value returned is the length of the data of the record found,
• the length of the key of the record is set in the out parameter okeylen,
• the key of the record is copied to okey,
• the current record of the file is set to the record found

long rc < 0:

• some error occured, see pbl_errno

Alphabetic index