echash_retrieve — Retrieve the data associated with the specified key
int **echash_retrieve(** ( | h, | |
| | k, | |
| | klen, | |
| | data
); | |
ec_hash_table * <var class="pdparam">h</var>;
const char * <var class="pdparam">k</var>;
int <var class="pdparam">klen</var>;
void ** <var class="pdparam">data</var>;
Retrieve a pointer to the data associated with the specified key.
The hash table
The length of the key
A pointer to the pointer where the retreived data will be found.
This function returns
1 on success and
0 on failure. After successful execution the data is found at *data.
When a key or value is returned, the memory is owned by the hash table. Your memory can become invalid if something else removes an entry from the table after you have queried it.
It is legal to call this function in any thread.
The hash table data structure is not thread safe; any simultaneous access needs to be coordinated by the API consumer.