BltIx4GetEqual


< Prev  TOC  Next >

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


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

This routine finds the exact match for the key in keyBufferPtr and the recNo in recNoPtr and returns its data record. If recNo is passed as zero, the first key matched is used (that is, the key with the lowest recNo).

This routine only finds exact matches. If the TBLT_DH.flags bit FLAGS_SKIP_DELETED_BIT, of khPtr->xbLinkPtr->flags, is set, this routine returns a EXB_KEY_NOT_FOUND if the found key has a data record marked with a * (star) in the delete tag field (the first byte of the data record).

Note: The key to find must match exactly with a key in the index file, for all keyLength bytes. The compare does not stop at a \0, even if the key is a character type.

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


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