echash_next — Move to the next item in the hash table
int **echash_next** ( | h, | |
| | iter, | |
| | k, | |
| | klen, | |
| | data
); | |
ec_hash_table * <var class="pdparam">h</var>;
ec_hash_iter * <var class="pdparam">iter</var>;
const char ** <var class="pdparam">k</var>;
int * <var class="pdparam">klen</var>;
void ** <var class="pdparam">data</var>;
Move to the next item found after the specified key. If a next item exists, the data associated with this position is found in
Do not write to a hash table while iterating over its contents.
The hash table
The hash iterator. For a description of this struct see ec_hash_iter.
The length of the key
Upon successful execution data * contains the the data associated with the next key.
On success this function returns
It is legal to call this function in any thread.
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.
The hash table data structure is not thread safe; any simultaneous access needs to be coordinated by the API consumer.