Struct Storage

pub struct Storage { /* private fields */ }

File memory map backed storage.

Attempting to resize storage results in error.

Implementations

impl Storage

pub fn open<P: AsRef<Path>>(path: P) -> Result<Self>

Creates storage by opening or creating file at the specified location.

If file is newly created it is appended dummy byte.

pub fn open_exising<P: AsRef<Path>>(path: P) -> Result<Self>

Opens storage, if it doesn’t exist return error.

pub fn as_slice(&self) -> &[u8]

Returns slice with view on written data.

pub fn as_mut_slice(&mut self) -> &mut [u8]

Returns slice with view on written data.

pub fn capacity(&self) -> usize

Returns overall size of storage(including extra space).

pub fn flush_async(&self) -> Result<()>

Asynchronously flushes outstanding memory map modifications to disk.

This method initiates flushing modified pages to durable storage, but it will not wait for the operation to complete before returning.

pub fn flush_sync(&self) -> Result<()>

Synchronously flushes outstanding memory map modifications to disk.

pub fn resize(&mut self, new_size: usize) -> Result<()>

Resizes storage by appending or truncating.

It modifies file size and re-mmaps file. When Attempting to set size to 0, the actual size will become 1.

If current cursor of data becomes out of actual file storage, it is shifted to actual file storage size

pub fn put_data(&mut self, data: &[u8]) -> Result<()>

Resizes map accordingly to data and copies it.

Convenience method to map buffer to file.

pub fn extend_from_slice(&mut self, data: &[u8]) -> Result<()>

Appends data to storage

Note that it resizes storage if needed. Therefore error can happen.

pub fn copy_from_slice(&mut self, data: &[u8])

Copies data from slice into storage.

Function panics if data has greater len.

Note: It copies data up to storage capacity.

pub fn to_vec(&self) -> Vec<u8>

Creates Vec from content of storage.

Trait Implementations

impl Write for Storage

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

Writes a buffer into this writer, returning how many bytes were written.

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

Attempts to write an entire buffer into this writer.

fn flush(&mut self) -> Result<()>

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

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

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

fn is_write_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

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

🔬This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

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

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

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.