Cleanup Tuple to allow self-typing.
[rrq/rrqmisc.git] / vector / HashVector.h
index 0b4a0f6c19c38c7fac86a3a1c93448cb79b6fedd..387f7ce53cbe3782fee880af84e5f6c0af71a238 100644 (file)
@@ -73,7 +73,7 @@ typedef struct {
 #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.
  *
@@ -86,18 +86,21 @@ typedef struct {
 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);