Struct Extents 

pub struct Extents { /* private fields */ }

Container for active mappings associated with a session. Extents are stored in compact form (ExtentEntry, 16 bytes) in a boxed slice sorted by ascending end_logical_offset to support clean O(log N) binary search lookups.

Implementations

impl Extents

pub fn encode_extents(extents: &[Extent]) -> Vec<u64>

Encodes a slice of Extents into 64-bit mapping descriptors.

Panics

Panics if any Extent in extents has a logical_range or device_offset that is not a multiple of BLOCK_SIZE (4096 bytes).

pub fn from_encoded(encoded: &[u64]) -> Option<Self>

Decodes a sequence of 64-bit mapping descriptors into a compact Extents container. Returns None if an unknown mapping descriptor type is encountered.

pub fn iter_extents(&self, start_offset: u64) -> ExtentsIterator<'_>

Returns an iterator over all extents whose logical range ends after start_offset, jumping directly to the first overlapping extent in O(log N) time via binary search.

pub fn map(&self, offset: u64) -> Option<Extent>

Maps a logical byte offset to the corresponding Extent in O(log N) time using binary search, translating logical and physical ranges to start at offset.

Panics

Panics if offset is not a multiple of BLOCK_SIZE (4096 bytes).

pub fn mappings(&self) -> Vec<Extent>

Returns all mappings as full Extent structs.

Trait Implementations

impl Clone for Extents

fn clone(&self) -> Extents

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Extents

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

Formats the value using the given formatter.

impl Default for Extents

fn default() -> Extents

Returns the “default value” for a type.

impl Eq for Extents

impl PartialEq for Extents

fn eq(&self, other: &Extents) -> 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 Extents