#define HV_HOLE ((void*) 1)
/**
- * \brief Find the keyed item.
+ * \brief Lookup the first item with the given key.
*
* \param hv is the \ref HashVector concerned.
*
void *HashVector_find(HashVector *hv,void *key);
/**
- * \brief Scan the table for th next key-matching item at or after the
- * given index.
+ * \brief Scan the table for any subsequent item that admits to the
+ * given partial key.
*
* \param hv is the \ref HashVector concerned.
*
* \param index is a pointer to the index to advance.
* \
- * \param key is the Query key
+ * \param key is the query key
*
* \returns the next matching item, or \b 0 if none, with the index
* updated.
*
+ * This function is used where the query key doesn't fully identify an
+ * item, and is thus a partial key that
+ *
* \related HashVector
*/
extern void *HashVector_next(HashVector *hv,VectorIndex *i,void *key);