Struct io_arrays::ArrayEditor

source · [−]

pub struct ArrayEditor { /* private fields */ }

Expand description

A random-access input source and output sink.

Implementations

source

impl ArrayEditor

source

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

Convert a File into a ArrayEditor.

source

pub fn anonymous() -> Result<Self>

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

Trait Implementations

source

impl Array for ArrayEditor

source

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. Read more

source

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

Announce the expected access pattern of the data at the given offset. Read more

source

impl AsHandle for ArrayEditor

source

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

Borrows the handle. Read more

source

impl AsRawHandle for ArrayEditor

source

fn as_raw_handle(&self) -> RawHandle

Extracts the raw handle, without taking any ownership.

source

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

Formats the value using the given formatter. Read more

source

impl ReadAt for ArrayEditor

source

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

Reads a number of bytes starting from a given offset. Read more

source

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. Read more

source

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

Is to read_vectored what read_at is to read.

source

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.

source

fn is_read_vectored_at(&self) -> bool

Determines if Self has an efficient read_vectored_at implementation. Read more

source

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

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

source

impl WriteAt for ArrayEditor

source

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

Writes a number of bytes starting from a given offset. Read more

source

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

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

source

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

Is to write_vectored what write_at is to write.

source

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.

source

fn is_write_vectored_at(&self) -> bool

Determines if Self has an efficient write_vectored_at implementation. Read more

source

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.

source

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

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

Auto Trait Implementations

impl RefUnwindSafe for ArrayEditor

impl Send for ArrayEditor

impl Sync for ArrayEditor

impl Unpin for ArrayEditor

impl UnwindSafe for ArrayEditor

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> AsFilelike for T where
T: AsHandle,

source

pub fn as_filelike(&self) -> BorrowedHandle<'_>

Borrows the reference. Read more

source

pub fn as_filelike_view<Target>(&self) -> FilelikeView<'_, Target> where
Target: FromFilelike + IntoFilelike,

Return a borrowing view of a resource which dereferences to a &Target or &mut Target. Read more

source

impl<T> AsRawFilelike for T where
T: AsRawHandle,

source

pub fn as_raw_filelike(&self) -> *mut c_void

Returns the raw value.

source

impl<T> AsRawGrip for T where
T: AsRawHandleOrSocket,

source

pub fn as_raw_grip(&self) -> RawHandleOrSocket

Extracts the raw grip.

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> FileIoExt for T where
T: AsFilelike,

source

pub fn advise(
 &self,
 _offset: u64,
 _len: u64,
 _advice: Advice
) -> Result<(), Error>

Announce the expected access pattern of the data at the given offset.

source

pub fn allocate(&self, _offset: u64, _len: u64) -> Result<(), Error>

Allocate space in the file, increasing the file size as needed, and ensuring that there are no holes under the given range. Read more

source

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

Pull some bytes from this source into the specified buffer, returning how many bytes were read. Read more

source

pub fn read_exact(&self, buf: &mut [u8 ]) -> Result<(), Error>

Read the exact number of bytes required to fill buf. Read more

source

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

Reads a number of bytes starting from a given offset. Read more

source

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

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

source

pub fn read_vectored(&self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers. Read more

source

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

Is to read_vectored what read_at is to read.

source

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

Is to read_exact_vectored what read_exact_at is to read_exact.

source

pub fn is_read_vectored_at(&self) -> bool

Determines if this Reader has an efficient read_vectored_at implementation. Read more

source

pub fn read_to_end(&self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>

Read all bytes until EOF in this source, placing them into buf. Read more

source

pub fn read_to_end_at(
 &self,
 buf: &mut Vec<u8, Global>,
 offset: u64
) -> Result<usize, Error>

Read all bytes, starting at offset, until EOF in this source, placing them into buf. Read more

source

pub fn read_to_string(&self, buf: &mut String) -> Result<usize, Error>

Read all bytes until EOF in this source, appending them to buf. Read more

source

pub fn read_to_string_at(
 &self,
 buf: &mut String,
 offset: u64
) -> Result<usize, Error>

Read all bytes, starting at offset, until EOF in this source, appending them to buf. Read more

source

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

Read bytes from the current position without advancing the current position. Read more

source

pub fn write(&self, buf: &[u8 ]) -> Result<usize, Error>

Write a buffer into this writer, returning how many bytes were written. Read more

source

pub fn write_all(&self, buf: &[u8 ]) -> Result<(), Error>

Attempts to write an entire buffer into this writer. Read more

source

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

Writes a number of bytes starting from a given offset. Read more

source

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

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

source

pub fn write_vectored(&self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers. Read more

source

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

Is to write_vectored what write_at is to write.

source

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

Is to write_all_vectored what write_all_at is to write_all.

source

pub fn is_write_vectored_at(&self) -> bool

Determines if this Writer has an efficient write_vectored_at implementation. Read more

source

pub fn flush(&self) -> Result<(), Error>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination. Read more

source

pub fn write_fmt(&self, fmt: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered. Read more

source

pub fn seek(&self, pos: SeekFrom) -> Result<u64, Error>

Seek to an offset, in bytes, in a stream. Read more

source

pub fn stream_position(&self) -> Result<u64, Error>

Returns the current seek position from the start of the stream. Read more

source

fn read_exact_vectored(&self, bufs: &mut [IoSliceMut<'_>]) -> Result<(), Error>

Is to read_vectored what read_exact is to read.

source

fn write_all_vectored(&self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

Is to write_vectored what write_all is to write.

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T> GetSetFdFlags for T

source

pub fn get_fd_flags(&self) -> Result<FdFlags, Error> where
T: AsFilelike,

Query the “status” flags for the self file descriptor.

source

pub fn new_set_fd_flags(
 &self,
 fd_flags: FdFlags
) -> Result<SetFdFlags<T>, Error> where
 T: AsFilelike + FromFilelike,

Create a new SetFdFlags value for use with set_fd_flags. Read more

source

pub fn set_fd_flags(&mut self, set_fd_flags: SetFdFlags<T>) -> Result<(), Error> where
T: AsFilelike,

Set the “status” flags for the self file descriptor. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Performs the conversion.

impl<T> SetTimes for T where
T: AsFilelike,

pub fn set_times(
 &self,
 atime: Option<SystemTimeSpec>,
 mtime: Option<SystemTimeSpec>
) -> Result<(), Error>

Set the last access and last modification timestamps of an open file handle. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct io_arrays::ArrayEditor

Implementations

impl ArrayEditor

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

pub fn anonymous() -> Result<Self>

Trait Implementations

impl Array for ArrayEditor

fn metadata(&self) -> Result<Metadata>

fn advise(&self, offset: u64, len: u64, advice: Advice) -> Result<()>

impl AsHandle for ArrayEditor

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

impl AsRawHandle for ArrayEditor

fn as_raw_handle(&self) -> RawHandle

impl AsRawHandleOrSocket for ArrayEditor

fn as_raw_handle_or_socket(&self) -> RawHandleOrSocket

impl Debug for ArrayEditor

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

impl ReadAt for ArrayEditor

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

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

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

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

fn is_read_vectored_at(&self) -> bool

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

impl WriteAt for ArrayEditor

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

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

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

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

fn is_write_vectored_at(&self) -> bool

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

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

Auto Trait Implementations

impl RefUnwindSafe for ArrayEditor

impl Send for ArrayEditor

impl Sync for ArrayEditor

impl Unpin for ArrayEditor

impl UnwindSafe for ArrayEditor

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> AsFilelike for T where T: AsHandle,

pub fn as_filelike(&self) -> BorrowedHandle<'_>

pub fn as_filelike_view<Target>(&self) -> FilelikeView<'_, Target> where Target: FromFilelike + IntoFilelike,

impl<T> AsRawFilelike for T where T: AsRawHandle,

pub fn as_raw_filelike(&self) -> *mut c_void

impl<T> AsRawGrip for T where T: AsRawHandleOrSocket,

pub fn as_raw_grip(&self) -> RawHandleOrSocket

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> FileIoExt for T where T: AsFilelike,

pub fn advise( &self, _offset: u64, _len: u64, _advice: Advice) -> Result<(), Error>

pub fn allocate(&self, _offset: u64, _len: u64) -> Result<(), Error>

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

pub fn read_exact(&self, buf: &mut [u8]) -> Result<(), Error>

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

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

pub fn read_vectored(&self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

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

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

pub fn is_read_vectored_at(&self) -> bool

pub fn read_to_end(&self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>

pub fn read_to_end_at( &self, buf: &mut Vec<u8, Global>, offset: u64) -> Result<usize, Error>

pub fn read_to_string(&self, buf: &mut String) -> Result<usize, Error>

pub fn read_to_string_at( &self, buf: &mut String, offset: u64) -> Result<usize, Error>

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

pub fn write(&self, buf: &[u8]) -> Result<usize, Error>

pub fn write_all(&self, buf: &[u8]) -> Result<(), Error>

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

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

pub fn write_vectored(&self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

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

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

pub fn is_write_vectored_at(&self) -> bool

pub fn flush(&self) -> Result<(), Error>

pub fn write_fmt(&self, fmt: Arguments<'_>) -> Result<(), Error>

pub fn seek(&self, pos: SeekFrom) -> Result<u64, Error>

pub fn stream_position(&self) -> Result<u64, Error>

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

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

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

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

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

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

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

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

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

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

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> AsFilelike for T where
T: AsHandle,

pub fn as_filelike_view<Target>(&self) -> FilelikeView<'_, Target> where
Target: FromFilelike + IntoFilelike,

impl<T> AsRawFilelike for T where
T: AsRawHandle,

impl<T> AsRawGrip for T where
T: AsRawHandleOrSocket,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T> FileIoExt for T where
T: AsFilelike,

pub fn advise(
&self,
_offset: u64,
_len: u64,
_advice: Advice
) -> Result<(), Error>

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

pub fn read_exact(&self, buf: &mut [u8 ]) -> Result<(), Error>

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

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

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

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

pub fn read_to_end_at(
&self,
buf: &mut Vec<u8, Global>,
offset: u64
) -> Result<usize, Error>

pub fn read_to_string_at(
&self,
buf: &mut String,
offset: u64
) -> Result<usize, Error>

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

pub fn write(&self, buf: &[u8 ]) -> Result<usize, Error>

pub fn write_all(&self, buf: &[u8 ]) -> Result<(), Error>

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

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

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

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

pub fn get_fd_flags(&self) -> Result<FdFlags, Error> where
T: AsFilelike,

pub fn new_set_fd_flags(
&self,
fd_flags: FdFlags
) -> Result<SetFdFlags<T>, Error> where
T: AsFilelike + FromFilelike,

pub fn set_fd_flags(&mut self, set_fd_flags: SetFdFlags<T>) -> Result<(), Error> where
T: AsFilelike,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> SetTimes for T where
T: AsFilelike,

pub fn set_times(
&self,
atime: Option<SystemTimeSpec>,
mtime: Option<SystemTimeSpec>
) -> Result<(), Error>

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,