Struct io_arrays::ArrayEditor

pub struct ArrayEditor { /* private fields */ }

A random-access input source and output sink.

Implementations

impl ArrayEditor

pub fn file<Filelike: IntoFilelike + Read + Write + Seek>( filelike: Filelike ) -> Self

Convert a File into a ArrayEditor.

pub fn anonymous() -> Result<Self>

Create a temporary anonymous resource which can be accessed in the manner of an array.

Trait Implementations

impl Array for &ArrayEditor

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.

impl Array for ArrayEditor

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.

impl AsHandle for ArrayEditor

fn as_handle(&self) -> BorrowedHandle<'_>

Borrows the handle.

impl AsRawHandle for ArrayEditor

fn as_raw_handle(&self) -> RawHandle

Extracts the raw handle.

impl AsRawHandleOrSocket for ArrayEditor

fn as_raw_handle_or_socket(&self) -> RawHandleOrSocket

Like AsRawHandle::as_raw_handle and AsRawSocket::as_raw_socket but can return either type.

impl Debug for ArrayEditor

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

Formats the value using the given formatter.

impl ReadAt for ArrayEditor

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

Reads a number of bytes starting from a given offset.

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

Reads the exact number of byte required to fill buf from the given offset.

fn read_vectored_at( &self, bufs: &mut [IoSliceMut<'_>], offset: u64 ) -> Result<usize>

Is to read_vectored what read_at is to read.

fn read_exact_vectored_at( &self, bufs: &mut [IoSliceMut<'_>], offset: u64 ) -> Result<()>

Is to read_exact_vectored what read_exact_at is to read_exact.

fn is_read_vectored_at(&self) -> bool

Determines if Self has an efficient read_vectored_at implementation.

fn read_via_stream_at(&self, offset: u64) -> Result<StreamReader>

Create a StreamReader which reads from the array at the given offset.

impl WriteAt for &ArrayEditor

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

Writes a number of bytes starting from a given offset.

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

Attempts to write an entire buffer starting from a given offset.

fn write_vectored_at( &mut self, bufs: &[IoSlice<'_>], offset: u64 ) -> Result<usize>

Is to write_vectored what write_at is to write.

fn write_all_vectored_at( &mut self, bufs: &mut [IoSlice<'_>], offset: u64 ) -> Result<()>

Is to write_all_vectored what write_all_at is to write_all.

fn is_write_vectored_at(&self) -> bool

Determines if Self has an efficient write_vectored_at implementation.

fn copy_from<R: ReadAt>( &mut self, offset: u64, input: &R, input_offset: u64, len: u64 ) -> Result<u64>

Copy len bytes from input at input_offset to self at offset.

fn set_len(&mut self, size: u64) -> Result<()>

Truncates or extends the underlying array, updating the size of this array to become size.

impl WriteAt for ArrayEditor

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

Writes a number of bytes starting from a given offset.

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

Attempts to write an entire buffer starting from a given offset.

fn write_vectored_at( &mut self, bufs: &[IoSlice<'_>], offset: u64 ) -> Result<usize>

Is to write_vectored what write_at is to write.

fn write_all_vectored_at( &mut self, bufs: &mut [IoSlice<'_>], offset: u64 ) -> Result<()>

Is to write_all_vectored what write_all_at is to write_all.

fn is_write_vectored_at(&self) -> bool

Determines if Self has an efficient write_vectored_at implementation.

fn copy_from<R: ReadAt>( &mut self, offset: u64, input: &R, input_offset: u64, len: u64 ) -> Result<u64>

Copy len bytes from input at input_offset to self at offset.

fn set_len(&mut self, size: u64) -> Result<()>

Truncates or extends the underlying array, updating the size of this array to become size.