rc_hash_iterate

Generates the next hash associated to an rc_hash_iterator.

Syntax

int rc_hash_iterate(
    char hash[33], 
    rc_hash_iterator_t* iterator
);

Parameters

hash

A buffer to write the calculated hash into. The resulting hash will be 32 characters long, plus a null terminator.

iterator

Pointer to an rc_hash_iterator object previously initialized by rc_hash_initialize_iterator.

Return value

If a hash was generated, the return value is non-zero and hash will be populated with the calculated hash.

If no hash was generated, the return value is zero. This usually means there are no more applicable hashes for the provided content.

If no has was generated as the result of a failure, the failure could be captured by registering a handler in the iterator callbacks.

Remarks

This function is normally called when the console associate to the content is not known. If the console is known, it's preferable to call rc_hash_generate.

Additional details about the hashing process can be captured by registering a handler in the iterator callbacks.

Minimum version: 9.0.0

See also

rc_hash_initialize_iterator

rc_hash_destroy_iterator

rc_hash_generate