diff options
Diffstat (limited to 'src/coucal.h')
-rw-r--r-- | src/coucal.h | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/src/coucal.h b/src/coucal.h index 1d6585f..2012db5 100644 --- a/src/coucal.h +++ b/src/coucal.h @@ -423,6 +423,20 @@ COUCAL_EXTERN int coucal_inc(coucal hashtable, coucal_key_const name); COUCAL_EXTERN int coucal_dec(coucal hashtable, coucal_key_const name); /** + * Fetch an entry value from the hashtable, given a name, and its hashes. + * Returns NULL if the entry could not be found. + * The returned pointer is only valid until next call to this library, and can + * be used for read or write operations. + * The hashes MUST have been computed using either coucal_hash_string(), or + * coucal_hash_data(), or by copying an existing hash during an enumeration. + * The use of a non-matching hash is safe, but will return NULL. + **/ +COUCAL_EXTERN coucal_value* coucal_fetch_value_hashes(coucal hashtable, + coucal_key_const name, + const coucal_hashkeys + *hashes); + +/** * Remove an entry from the hashtable * Return non-zero value if the entry was removed, zero otherwise. **/ |