Struct io_arrays::ArrayWriter

pub struct ArrayWriter { /* private fields */ }

A random-access output sink.

Implementations

impl ArrayWriter

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

Convert a File into a ArrayWriter.

The file must not be opened in append mode.

Trait Implementations

impl Array for &ArrayWriter

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 ArrayWriter

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 ArrayWriter

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

Borrows the handle.

impl AsRawHandle for ArrayWriter

fn as_raw_handle(&self) -> RawHandle

Extracts the raw handle.

impl AsRawHandleOrSocket for ArrayWriter

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 ArrayWriter

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

Formats the value using the given formatter.

impl WriteAt for &ArrayWriter

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 ArrayWriter

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.