Struct ObjectReader 

pub struct ObjectReader<'repo, R>
where
    R: Repository + ?Sized,
{ /* private fields */ }

A cursor over a stable repository object. It contains only a repository reference, index, metadata, and offset, with no body buffer or allocation. Use core::mem::size_of::<ObjectReader<'_, R>>() for the host’s state budget.

Implementations

impl<'repo, R> ObjectReader<'repo, R>

where R: Repository + ?Sized,

pub fn new( repository: &'repo R, index: usize, ) -> Result<ObjectReader<'repo, R>, Error>

pub fn info(&self) -> ObjectInfo

pub fn object_format(&self) -> ObjectFormat

pub fn position(&self) -> u64

pub fn remaining(&self) -> u64

pub fn seek(&mut self, position: u64) -> Result<(), Error>

Resume or reread at an offset within the body, including EOF.

pub fn read(&mut self, storage: &mut [u8]) -> Result<usize, Error>

Read one bounded chunk. Empty scratch is an error unless at EOF. Early EOF or a provider reporting more bytes than requested is InvalidObject. On error the position is unchanged, so a stable provider can be retried.