Signature
native TrieIter:TrieIterCreate(Trie:handle);
Description
Creates an iterator for a map. It provides iterative read-only access to the
maps contents.
Notes
-
Removing or adding keys to the underlying map will invalidate all its
iterators. Updating values of existing keys is allowed and the changes
will be immediately reflected in the iterator.
-
Iterators are designed to be short-lived and not stored, and creating
them is very cheap. Reading data from an iterator is just as fast as
reading directly from the map.
- Just like in snapshots the keys are not sorted.
Parameters
- handle — Iterator handle
Returns
New iterator handle, which must be freed via TrieIterDestroy().
Errors
- Invalid Handle