dict_next — Fetch the next key/value pair
int **dict_next** ( | a, | |
| | i, | |
| | key, | |
| | val
); | |
ECDict <var class="pdparam">a</var>;
ECDict_Iterator * <var class="pdparam">i</var>;
const char ** <var class="pdparam">key</var>;
const char ** <var class="pdparam">val</var>;
If there is another key/value pair in the dictionary, fetch it.
The ECDict. An ECDict is a typedef of an ec_hash_table.
The iterator. An ECDict_Iterator is a typedef of an ec_hash_iter.
The current key.
The value associated with the
1 if there is a next key. Otherwise,
0 is returned.
* key points to the next key and
* val to the associated value.
When a key or value is returned, the memory is owned by the dictionary. Your memory can become invalid if something else removes an entry from the dictionary after you have queried it.
It is legal to call this function in any thread.