Trait Array

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

A minimal base trait for array I/O. Defines operations common to all kinds of random-access devices that fit the “array” 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 array. 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.

Implementations on Foreign Types

impl Array for &File

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

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

impl Array for &mut Vec<u8>

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

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

impl Array for &mut [u8]

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

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

impl Array for Vec<u8>

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

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

impl Array for File

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

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

impl Array for [u8]

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

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

Implementors

impl Array for &ArrayEditor

impl Array for &ArrayReader

impl Array for &ArrayWriter

impl Array for ArrayEditor

impl Array for ArrayReader

impl Array for ArrayWriter