Struct brownstone::move_builder::ArrayBuilder

pub struct ArrayBuilder<T, const N: usize> { /* fields omitted */ }

Misuse-immune array builder

This ArrayBuilder uses move semantics to provide an array builder that never panics or returns errors. Each call to push takes self by move, and returns either the builder (if it’s not full yet) or the fully initialized array (if it is). The builder therefore can only exist while the array being built isn’t full yet.

Implementations

impl<T, const N: usize> ArrayBuilder<T, N>

pub fn start() -> PushResult<T, N>

Create a new ArrayBuilder. If N == 0, immediately return an empty array, rather than the builder.

pub fn is_empty(&self) -> bool

Returns true if there are no initialized elements in the array

pub fn len(&self) -> usize

Returns the number of initialized elements in the array

pub fn push(self, value: T) -> PushResult<T, N>

Add a new initialized element to the array. If this causes the array to become fully initialzed, the array is returned; otherwise, the builder is returned.

pub fn finished_slice(&self) -> &[T]

Get the slice of the array that has already been initialized.

pub fn finished_slice_mut(&mut self) -> &mut [T]

Get the mutable slice of the array that has already been initialized.

Trait Implementations

impl<T: Clone, const N: usize> Clone for ArrayBuilder<T, N>

fn clone(&self) -> ArrayBuilder<T, N>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug, const N: usize> Debug for ArrayBuilder<T, N>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.