BltIx4GetEqualOrLesser


< Prev  TOC  Next >

TBLT_RETC TBLT_ENTRY BltIx4GetEqualOrLesser(TBLT_KH *khPtr,
                                            VOID *keyBufferPtr,
                                            ULONG *recNoPtr,
                                            VOID *recordPtr);


 khPtr          I:index file control structure
 keyBufferPtr   IO:key to find/key found
 recNoPtr       IO:recNo to match (or 0)/recNo of key found
 recordPtr      O:record data of found key

This routine finds either the exact match for the key in keyBufferPtr and the recNo in recNoPtr (if not zero, the first key-match if zero), or the previous, lesser key and its recNoPtr and returns the key, the record number, and the data record of that key.

The previous lesser key is the key that would have preceded the exact key to find had that key been in the index file. If the TBLT_DH.flags bit FLAGS_SKIP_DELETED_BIT, of khPtr->xbLinkPtr->flags, is set, this routine skips over all data records marked with a * (star) in the delete tag field (the first byte of the data record).

Return: Non-zero indicates an error, otherwise the keyBufferPtr/recNo/recordPtr is returned.


All content Copyright © 1999 Cornel Huth. All rights reserved.