Struct vmcircbuf::Buffer

pub struct Buffer { /* fields omitted */ }

A raw circular buffer of bytes. The buffer holds exactly size many bytes but it is presented as a size + wrap length slice where the last wrap many bytes overlap with the first wrap many bytes of the slice. This magic trick is performed with virtual memory, the same physical pages are mapped both at the start and at the end of the buffer.

Methods

impl Buffer

pub fn page_size() -> Result<usize, Error>

Returns the page size of the underlying operating system.

pub fn new(size: usize, wrap: usize) -> Result<Buffer, Error>

Creates a new circular buffer with the given size and wrap. The returned size and wrap will be rounded up to an integer multiple of the page size. The wrap value cannot be larger than size, and both can be zero to get exactly the page size.

pub fn size(&self) -> usize

Returns the size of the circular buffer.

pub fn wrap(&self) -> usize

Returns the wrap of the circular buffer.

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

Returns an immutable slice of the circular buffer. The last wrap many bytes are mapped to the first wrap many bytes, so you can read the same content at both places.

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

Returns a mutable slice of the circular buffer. The last wrap many bytes are mapped to the first wrap many bytes, so you can read and write the same content at both places.

Trait Implementations

impl Drop for Buffer

fn drop(&mut self)

Executes the destructor for this type.

impl<I: SliceIndex<[u8]>> Index<I> for Buffer

type Output = I::Output

The returned type after indexing.

fn index(&self, index: I) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<I: SliceIndex<[u8]>> IndexMut<I> for Buffer

fn index_mut(&mut self, index: I) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl Send for Buffer

impl Sync for Buffer