Struct Producer 

pub struct Producer<'a, const N: usize> { /* private fields */ }

A Producer is a smart pointer to a Buffer, which is endowed with the right to add data into the buffer. Only one Producer may exist at one time for any given buffer. The methods of a Producer are the only way to insert data into a Buffer.

Implementations

impl<'a, const N: usize> Producer<'a, N>

pub fn write<'b>(&'b mut self, target_len: usize) -> Region<'b, Self>

Return a Region for up to target_len bytes to be written into the buffer. The returned region may be shorter than target_len. The returned region has length zero if and only if the buffer is full. The returned region is guaranteed to be not longer than target_len. To write the largest possible length, set target_len = usize::MAX.

Examples found in repository

examples/two_threads.rs (line 7)

fn producer(mut p: fring::Producer<N>) {
    let mut index = 'a' as u8;
    for _ in 0..8 {
        std::thread::sleep(std::time::Duration::from_millis(25));
        let mut w = p.write(3);
        for i in 0..w.len() {
            w[i] = index;
            index += 1;
        }
        println!("write \"{}\"", std::str::from_utf8(&*w).unwrap());
    }
}

pub fn write_ref<T: ?Sized>(&mut self, item: &T) -> Result<(), ()>

If the buffer has room for *item, write it into the buffer and return Ok. Otherwise, return Err.

pub fn empty_size(&self) -> usize

Return the amount of empty space currently available in the buffer. If the consumer is reading concurrently with this call, then the amount of empty space may increase, but it will not decrease below the value which is returned.