Struct Pooled 

pub struct Pooled { /* private fields */ }

A file whose batched reads go through a Pool.

Everything else is the file underneath, unchanged. read_at in particular stays synchronous on the calling thread, because handing one read to another thread and then blocking on it is two context switches to do what the caller was going to do anyway.

Implementations

impl Pooled

pub fn new(file: Box<dyn File>, pool: Pool) -> Self

Puts pool underneath file.

pub fn pool(&self) -> &Pool

The pool this file reads through.

Trait Implementations

impl Debug for Pooled

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

Formats the value using the given formatter.

impl File for Pooled

fn read_at(&self, offset: u64, buf: &mut [u8]) -> Result<usize>

Reads into buf starting at offset and returns how many bytes were read.

fn submit(&self, requests: Vec<Request>) -> Completion

States every read the caller wants and hands back something to wait on or poll.

fn write_at(&self, offset: u64, data: &[u8]) -> Result<()>

Writes all of data starting at offset, extending the file if it has to.

fn sync(&self) -> Result<()>

Makes every write issued before this call durable.

fn truncate(&self, len: u64) -> Result<()>

Cuts the file to len bytes, or extends it with zeroes.

fn len(&self) -> Result<u64>

How many bytes long the file currently is.

fn read_exact_at(&self, offset: u64, buf: &mut [u8]) -> Result<()>

Reads exactly buf.len() bytes starting at offset.

fn is_empty(&self) -> Result<bool>

Whether the file has no bytes in it.