Struct MmapFile 

pub struct MmapFile { /* private fields */ }

A handle to a memory-mapped file

This structure provides safe access to memory-mapped files with proper lifetime management and error handling.

Implementations

impl MmapFile

pub fn new<P: AsRef<Path>>(path: P) -> Result<Self, MmapError>

Create a new memory-mapped file from a path

Arguments

• path - Path to the file to be memory-mapped

Returns

A Result containing the MmapFile or an error

Safety

This function is safe because it ensures:

• File handle is valid
• Memory map is created successfully
• Lifetime of the mmap is tied to the struct

pub fn bytes(&self) -> Bytes

Get the full file contents as a Bytes object (zero-copy)

This returns a Bytes object that references the memory-mapped region without copying the data.

pub fn range(&self, range: Range<usize>) -> Result<Bytes, MmapError>

Get a range of bytes from the file (zero-copy slice)

Arguments

• range - The byte range to retrieve (start..end)

Returns

A Bytes object containing the requested range

pub fn size(&self) -> usize

Get the file size in bytes

pub fn path(&self) -> &Path

Get the file path

pub fn is_empty(&self) -> bool

Check if the file is empty

pub fn multi_range( &self, ranges: &[Range<usize>], ) -> Result<Vec<Bytes>, MmapError>

Get multiple ranges efficiently (for HTTP multi-range requests)

Arguments

• ranges - Vector of byte ranges to retrieve

Returns

A vector of Bytes objects, one for each range

Trait Implementations

impl Clone for MmapFile

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.