Struct ReadOptions 

#[non_exhaustive]
pub struct ReadOptions {
    pub max_bytes: Option<usize>,
}

Allocation policy for decoding an untrusted .nir file with read_with.

max_bytes is a decoded-allocation budget, not an on-disk file-size limit and not a bound on the returned graph’s exact resident size. Charging is monotonic and conservative: temporary allocations stay charged after they are released. The exact rules are:

• numeric datasets: element count times decoded width;
• u64 datasets: both the temporary Vec<u64> and converted Vec<i64>;
• i64 extent lists converted to Vec<usize> (e.g. Input.shape): both the source Vec<i64> and the destination Vec<usize>;
• fixed strings: fixed-capacity HDF5 buffers, resulting String headers, and the worst-case copied payload;
• variable-length strings: descriptor buffers, payload bytes reported by H5Dvlen_get_buf_size, resulting String headers, and copied payload. Scalar VLEN strings use the containing file size as a payload bound because H5Dvlen_get_buf_size can abort on scalar VLEN;
• scalar metadata: its decoded width;
• missing v_reset and w_in: the synthesized tensor payload.

All arithmetic is checked; overflow is treated as over budget. Node and link names, collection bookkeeping, allocator overhead, and libhdf5’s own caches are not charged.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

max_bytes: Option<usize>

Maximum total bytes charged by decoded allocations, or None for no allocation budget.

Implementations

impl ReadOptions

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

Set the decoded-allocation budget in bytes; None makes it unbounded.

Trait Implementations

impl Clone for ReadOptions

fn clone(&self) -> ReadOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadOptions

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

Formats the value using the given formatter.

impl Default for ReadOptions

fn default() -> ReadOptions

Returns the “default value” for a type.

impl Eq for ReadOptions

impl PartialEq for ReadOptions

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReadOptions