Trait io_ranges::Range

pub trait Range {
    fn metadata(&self) -> Result<Metadata>;
    fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>;
}

A minimal base trait for range I/O. Defines operations common to all kinds of random-access devices that fit the "range" concept, including normal files, block devices, and in-memory buffers.

This is a base trait that ReadAt, WriteAt, and EditAt all share.

Required methods

fn metadata(&self) -> Result<Metadata>

Return the Metadata for the range. This is similar to std::fs::File::metadata, though it returns fewer fields since the underlying device may not be an actual filesystem inode.

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

Announce the expected access pattern of the data at the given offset.

This is purely a performance hint and has no semantic effect.

Loading content...

Implementations on Foreign Types

impl Range for File

fn metadata(&self) -> Result<Metadata>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

impl Range for [u8]

fn metadata(&self) -> Result<Metadata>

fn advise(&self, _offset: u64, _len: u64, _advice: Advice) -> Result<()>

impl Range for Vec<u8>

fn metadata(&self) -> Result<Metadata>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

Loading content...

Implementors

impl Range for RangeEditor

fn metadata(&self) -> Result<Metadata>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

impl Range for RangeReader

fn metadata(&self) -> Result<Metadata>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

impl Range for RangeWriter

fn metadata(&self) -> Result<Metadata>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

Loading content...