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 base_device_offset(&self) -> u64

Returns the base device offset of this container.

pub fn try_new( extents: impl IntoIterator<Item = impl Borrow<Extent>>, base_device_offset: u64, ) -> Result<Self, Error>

Creates an Extents container from an iterator of Extents, returning an Error if validation fails.

pub fn encode(&self) -> impl Iterator<Item = u64> + '_

Encodes this Extents container into 64-bit mapping descriptors relative to its base device offset.

pub fn encode_extents(extents: &Extents) -> impl Iterator<Item = u64> + '_

Encodes an Extents container into 64-bit mapping descriptors.

pub fn encode_extents_with_base_offset( extents: &Extents, ) -> impl Iterator<Item = u64> + '_

Encodes an Extents container into 64-bit mapping descriptors relative to its base device offset.

pub fn from_encoded( encoded: impl IntoIterator<Item = u64>, base_device_offset: u64, ) -> Option<Self>

Decodes a sequence of 64-bit mapping descriptors into a compact Extents container, offsetting regular extents by base_device_offset. Returns None if an unknown mapping descriptor type is encountered or if an arithmetic overflow occurs while decoding.

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Extents