Struct ChunkCacheConfig 

pub struct ChunkCacheConfig { /* private fields */ }

Configuration for a per-dataset chunk cache.

The byte and slot limits are the hdf5-pure counterpart of the rdcc_nbytes and rdcc_nslots raw-data chunk-cache settings from HDF5’s H5Pset_cache. They apply to decompressed raw chunk data. The optional chunk-index cache controls whether hdf5-pure retains the parsed chunk address index between reads of the same crate::Dataset. Disabling the index cache lowers retained metadata memory at the cost of re-scanning the on-disk chunk index for repeated reads.

Implementations

impl ChunkCacheConfig

pub const fn new() -> Self

Create a config matching the historical defaults: 1 MiB of decompressed chunks, 16 slots, and retained parsed chunk indexes.

pub const fn from_h5p_cache(rdcc_nslots: usize, rdcc_nbytes: usize) -> Self

Create a config from HDF5 H5Pset_cache raw data chunk-cache values.

rdcc_nslots maps to the maximum retained chunk slots and rdcc_nbytes maps to the maximum retained decompressed chunk bytes. Modern HDF5 ignores H5Pset_cache’s mdc_nelmts; use crate::MetadataCacheConfig for the metadata-cache budget. The rdcc_w0 preemption policy has no direct equivalent because this read-only cache uses strict LRU eviction.

pub const fn disabled() -> Self

Disable retained decompressed chunks and parsed chunk indexes.

pub const fn with_max_bytes(self, max_bytes: usize) -> Self

Set the maximum decompressed chunk bytes retained per dataset.

pub const fn with_max_slots(self, max_slots: usize) -> Self

Set the maximum number of decompressed chunk slots retained per dataset.

pub const fn with_index_cache(self, enabled: bool) -> Self

Enable or disable retaining the parsed chunk index between reads.

pub const fn max_bytes(&self) -> usize

Return the maximum decompressed chunk bytes retained per dataset.

pub const fn max_slots(&self) -> usize

Return the maximum decompressed chunk slots retained per dataset.

pub const fn index_cache_enabled(&self) -> bool

Return whether parsed chunk indexes are retained between reads.

Trait Implementations

impl Clone for ChunkCacheConfig

fn clone(&self) -> ChunkCacheConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ChunkCacheConfig

impl Debug for ChunkCacheConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChunkCacheConfig

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ChunkCacheConfig

impl PartialEq for ChunkCacheConfig

fn eq(&self, other: &ChunkCacheConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ChunkCacheConfig