Struct TreeParams 

pub struct TreeParams<const BODY_SIZE: usize = DEFAULT_BODY_SIZE> { /* private fields */ }

Tree structure for a file of known size.

Pre-computes chunk counts and spans for efficient parallel operations. The branching factor defaults to BODY_SIZE / 32 (plain mode, 128 branches). Use with_ref_size for encrypted mode (BODY_SIZE / 64 = 64 branches).

Implementations

impl<const BODY_SIZE: usize> TreeParams<BODY_SIZE>

pub fn new(size: u64) -> Self

Create tree parameters for a file of given size (plain mode, REF_SIZE = 32).

pub fn with_ref_size(size: u64, ref_size: usize) -> Self

Create tree parameters with a custom reference size (e.g. 64 for encrypted mode).

pub const fn size(&self) -> u64

File size in bytes.

pub const fn depth(&self) -> usize

Tree depth (1 = single chunk, 2 = one intermediate level, etc.).

pub const fn data_chunks(&self) -> u64

Number of data chunks (level 0).

pub const fn total_chunks(&self) -> u64

Total chunks across all levels.

pub fn chunks_at_level(&self, level: usize) -> u64

Chunks at a specific level.

pub fn span_at(&self, level: usize, index: u64) -> u64

Span for a chunk at given level and index.

pub const fn chunk_offset(&self, chunk_index: u64) -> u64

Byte offset for start of chunk at level 0.

pub fn chunk_range(&self, chunk_index: u64) -> (u64, u64)

Byte range covered by a data chunk.

pub fn chunks_for_range(&self, offset: u64, len: u64) -> ChunkRange

Calculate required data chunks for a byte range.

Trait Implementations

impl<const BODY_SIZE: usize> Clone for TreeParams<BODY_SIZE>

fn clone(&self) -> TreeParams<BODY_SIZE>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const BODY_SIZE: usize> Copy for TreeParams<BODY_SIZE>

impl<const BODY_SIZE: usize> Debug for TreeParams<BODY_SIZE>

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

Formats the value using the given formatter.