Struct OffsetMap 

pub struct OffsetMap { /* private fields */ }

Remaps the offset of block requests based on an internal map of contiguous logical extents.

Implementations

impl OffsetMap

pub fn new(mappings: Vec<BlockOffsetMapping>) -> Result<Self, Status>

Creates a new OffsetMap from a list of BlockOffsetMappings. Returns INVALID_ARGS if any mapping length is zero, or if logical/target block offsets overflow u64.

pub fn empty() -> Self

Creates an empty OffsetMap.

pub fn map(&self, logical_offset: u64) -> Option<(u64, u32)>

Maps logical_offset to (target_block_offset, len), where len is the total number of blocks which can be addressed from target_block_offset onwards.

For example: if you have logical offset 0 pointing to physical extent 1000..1010, and you search for offset 5, the return value will be Some((1005, 5)).

pub fn is_empty(&self) -> bool

pub fn total_blocks(&self) -> u64

pub fn are_blocks_within_source_range( &self, (offset, length): (u64, u32), ) -> bool

Returns true if the block range [offset, offset + length) falls entirely within this map’s total blocks. If the map is empty, returns true (no range restriction).

pub fn mappings(&self) -> &[BlockOffsetMapping]

Trait Implementations

impl Clone for OffsetMap

fn clone(&self) -> OffsetMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OffsetMap

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

Formats the value using the given formatter.

impl Default for OffsetMap

fn default() -> OffsetMap

Returns the “default value” for a type.

impl Eq for OffsetMap

impl From<&OffsetMap> for Vec<BlockOffsetMapping>

fn from(offset_map: &OffsetMap) -> Self

Converts to this type from the input type.

impl PartialEq for OffsetMap

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

impl TryFrom<&[BlockOffsetMapping]> for OffsetMap

type Error = Status

The type returned in the event of a conversion error.

fn try_from(wire: &[BlockOffsetMapping]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<BlockOffsetMapping>> for OffsetMap

type Error = Status

The type returned in the event of a conversion error.

fn try_from(wire: Vec<BlockOffsetMapping>) -> Result<Self, Self::Error>

Performs the conversion.