Click above to get retro games delivered to your door ever month!

Name:       imatchkey

Purpose:    see if current record matches the given key

Prototype:  int imatchkey(Db_Obj      *db,
                          Index_Obj   *index,
                          char        *keyfields[]);

Header:     isam.h

Inputs:     db          - database handle
            index       - index handle
            keyfields   - array of pointers to keyfield strings

Description:
        imatchkey matches the current record of the index int the
        database db with the key given in the keyfields array, and
        returns YET if they match exactly (except for case), or NO otherwise.

        The key is specified in the keyfields array.  It is an argv-style
        array of pointer to character strings, just as in the ifindkey
        function.  The array need not be terminated by a NULL, but it won't
        hurt if it is.  Each element is the value of a key field.  For
        example, if an index is keyed on the fields "Zip" and "Name", the
        keyfields array would be two elements long and the values might be
        "99999" and "Jones".

Returns:
        YES, NO, or ERROR