Struct ReadOp 

pub struct ReadOp<'a, H>
where
    H: FileHandle + 'a,
{ /* private fields */ }

One consuming read operation. Construction performs no I/O or allocation. Caller buffers are borrowed only until Vfsi::vread returns, including on errors.

Implementations

impl<'a, H> ReadOp<'a, H>

where H: FileHandle + 'a,

pub fn whole<P>(path: &'a P) -> ReadOp<'a, H>

where P: AsRef<Path> + ?Sized,

Collect a complete file; fail instead of truncating at the byte budget.

pub fn range(file: &'a H, offset: u64, length: usize) -> ReadOp<'a, H>

Allocate a positional range. Short progress and EOF are reported explicitly.

pub fn into(file: &'a H, offset: u64, buffer: &'a mut [u8]) -> ReadOp<'a, H>

Fill caller storage at an absolute offset, without changing the cursor. The request length is exactly buffer.len().

pub fn whole_file_path(&self) -> Option<&'a Path>

Inspect a complete-file path from an external Vfsi implementation.

pub fn range_ref(&self) -> Option<&<H as FileHandle>::ReadRequest<'a>>

Borrow an allocating range request from an external implementation.

pub fn buffer_request_mut( &mut self, ) -> Option<&mut <H as FileHandle>::ReadIntoRequest<'a>>

Borrow a caller-buffer request exclusively from an external implementation.

Trait Implementations

impl<H> Debug for ReadOp<'_, H>

where H: FileHandle,

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

Formats the value using the given formatter.

impl<'a, H> From<&'a Path> for ReadOp<'a, H>

where H: FileHandle + 'a,

fn from(path: &'a Path) -> ReadOp<'a, H>

Converts to this type from the input type.

impl<'a, H> From<&'a str> for ReadOp<'a, H>

where H: FileHandle + 'a,

fn from(path: &'a str) -> ReadOp<'a, H>

Converts to this type from the input type.