rht_get_it is similar
to rht_get except that it fills
out a rht_it, which can be queried much like a rht_pair,
but does not need to be reclaimed like a rht_pair.
However, any such iterator is only valid while
this thread holds the lock. Once the lock is released
the iterator cannot be used.
If no equivalent entry exists the iterator will point
to the special "end entry" of the dictionary,
which is one past the last entry in the dictionary.
|