Name: H5Fget_mdc_hit_rate
Signature:
herr_t H5Fget_mdc_hit_rate(hid_t file_id, double *hit_rate_ptr)
Purpose:
Obtain target file's metadata cache hit rate.
Description:
H5Fget_mdc_hit_rate queries the metadata cache of the target file to obtain its hit rate (cache hits / (cache hits + cache misses)) since the last time hit rate statistics were reset. If the cache has not been accessed since the last time the hit rate stats were reset, the hit rate is defined to be 0.0.

The hit rate stats can be reset either manually (via H5Freset_mdc_hit_rate_stats()), or automatically. If the cache's adaptive resize code is enabled, the hit rate stats will be reset once per epoch. If they are reset manually as well, the cache may behave oddly.

See the overview of the metadata cache in the special topics section of the user manual for details on the metadata cache and its adaptive resize algorithms.

Parameters:
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.