rc_hash_initialize_iterator

Initializes an iterator object for use with the rc_hash_iterate function.

Syntax

void rc_hash_initialize_iterator(
    struct rc_hash_iterator* iterator, 
    const char* path, 
    uint8_t* buffer, 
    size_t buffer_size
);

Parameters

iterator

Pointer to the rc_hash_iterator object to be initialized.

path

The path to the file to be hashed. If providing a buffer, this must still be set so the filename extension can be used to help select the appropriate hashing algorithm for the data.

buffer

Pointer to the data to be hashed (usually an in-memory copy of the game file). If NULL, the file specified by the path parameter will be used.

buffer_size

The number of bytes pointed to by the buffer parameter. Ignored if buffer is NULL.

Remarks

If buffer is provided, path may be a filename (without an actual path). As rcheevos does not natively support compressed files, this could be the name of the file extracted from the archive, where buffer is the data extracted from the archive.

Minimum version: 9.0.0

See also

rc_hash_iterate

rc_hash_destroy_iterator