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_parts(&self) -> Option<(&'a H, u64, usize)>

Inspect the handle, absolute offset, and length of an allocating range.

pub fn buffer_parts_mut(&mut self) -> Option<(&'a H, u64, &mut [u8])>

Borrow the handle, absolute offset, and caller storage for direct dispatch.

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.