Struct WriteSlice

pub struct WriteSlice<'a, T: 'a>(/* private fields */);

Represents a write-only buffer.

You only write to individual elements of this slice; you can’t modify the slice itself or read from its elements.

It is generally advised to take an impl Into<WriteSlice> instead of a WriteSlice itself in APIs so that callers can pass in a a mutable reference.

Examples

fn copy<'a, T: Clone + 'a>(input: &[T], output: impl Into<WriteSlice<'a, T>>) {
    let mut output = output.into();
    for (i, val) in input.iter().enumerate() {
        output.write(i, val.clone());
    }
}
fn main() {
    let input = [1, 2, 3];
    let mut output = [7, 1, 9];
    copy(&input, &mut output as &mut [_]);
    assert_eq!(input, output);
}

Implementations

impl<'a, T: 'a> WriteSlice<'a, T>

pub fn write(&mut self, idx: usize, val: T)

Write a value to an element of this slice.

Panics

Panics if idx is out of bounds.

Trait Implementations

impl<'a, T: 'a> From<&'a mut [T]> for WriteSlice<'a, T>

fn from(inner: &'a mut [T]) -> Self

Converts to this type from the input type.