Reference Guide C API www.spreadconcepts.com


C API
Replicated Hash Table
Version 2.0


rht_get_it
  rht_code rht_get_it(rht r, rht_blob key, rht_it *i);


Parameters
  r replica to get an iterator from
  key key of the key value pair the iterator is being set to
  i returned iterator set to the key value pair cooresponding to the specified key


Return Values
  0 on success
  non-zero for error


Description
 

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.



Requirements
  Header: Declared in rht.h
Library: Use rht.lib
Version: 2.0


Also See
  RHT reference guide, local lock operations


Copyright © 2004, Spread Concepts LLC, All rights reserved