Struct jack::RingBufferReader

pub struct RingBufferReader { /* fields omitted */ }

Read end of the ring buffer. Can only be used from one thread (can be different from the write thread).

Methods

impl RingBufferReader

pub fn get_vector<'a>(&'a self) -> (&'a [u8], &'a [u8])

Fill a data structure with a description of the current readable data held in the ringbuffer. This description is returned in a two slices. Two slices are needed because the data to be read may be split across the end of the ringbuffer. The first slice represents the bytes ready to be read. If the second slice is not empty, it is the continuation of the data that ended in the first slices. For convenience, consider using peek_iter instead.

pub fn read_buffer(&mut self, buf: &mut [u8]) -> usize

Read data from the ringbuffer. Returns: the number of bytes read, which may range from 0 to buf.len().

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

Read data from the ringbuffer. Opposed to read_buffer() this function does not move the read pointer. Thus it's a convenient way to inspect data in the ringbuffer in a continous fashion. The price is that the data is copied into a user provided buffer. For "raw" non-copy inspection of the data in the ringbuffer use get_vector() or peek_iter. Returns: the number of bytes read, which may range from 0 to buf.len()

pub fn advance(&mut self, cnt: usize)

Advance the read pointer. use this after peek/peek_iter or get_vector to advance the buffer pointer.

pub fn space(&self) -> usize

Return the number of bytes available for reading.

pub fn peek_iter<'a>(&'a self) -> Chain<Iter<'a, u8>, Iter<'a, u8>>

Iterator that goes over all the data available to read.

Trait Implementations

impl Send for RingBufferReader

impl Read for RingBufferReader

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

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

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

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

unsafe fn initializer(&self) -> Initializer

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

Determines if this Reader can work with buffers of uninitialized memory.

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

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

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

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

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

Read the exact number of bytes required to fill buf.

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

Creates a "by reference" adaptor for this instance of Read.

fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an [Iterator] over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R> where
    R: Read, 

Creates an adaptor which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

Creates an adaptor which will read at most limit bytes from it.