Reference Guide C API www.spreadconcepts.com


Programmer's Reference Guide
Replicated Hash Table
Version 2.0


Iterator Operations

rht_it_update_type returns the update type of the key-value pair entry referenced by it. Currently, this can only be RHT_UPDATE_PUT or RHT_UPDATE_DEL, which correspond, respectively, to an entry place in the table by rht_put or rht_del. Note, the RHT_UPDATE_DEL type can only occur for special delete entries left in the dictionary when RHT_INTERSECT semantics are being used.

rht_it_key returns a constant pointer to the key of the key-value pair referenced by it.

rht_it_val returns a constant pointer to the value of the key-value pair referenced by it.

rht_it_time_stamp returns the Lamport Time Stamp (LTS) of the creation of this entry.

rht_it_eq compares two iterators for equality, returning true (non-zero) if the two iterators reference the same key-value pair or false (zero) otherwise. it1 and it2 must be valid iterators from the same replicant.

rht_it_next advances the iterator it to the next key-value pair in the referenced snapshot. Note that it is illegal to call this function on the special "end" position of the snapshot.



Copyright © 2004, Spread Concepts LLC, All rights reserved