Struct Sublist

pub struct Sublist<'a, E, MapFn, Parent, ParentErr>
where
    MapFn: FnOnce(ErrorList<E>) -> ParentErr,
    Parent: WriteErrorList<ParentErr>,
{ /* private fields */ }

A sublist that maps a list of errors into a parent error type

When an object of this type is dropped, it will call the given MapFn object with a ErrorList<E> containing all the errors that were pushed into it. The map function will be used to map that error list to a single ParentErr object which will then be pushed onto the parent’s error list.

This type implements DerefMut to an ErrorList, so it can basically be thought of as an ErrorList with a fancy destructor.

Implementations

impl<'a, E, MapFn, Parent, ParentErr> Sublist<'a, E, MapFn, Parent, ParentErr>

where MapFn: FnOnce(ErrorList<E>) -> ParentErr, Parent: WriteErrorList<ParentErr>,

pub fn new(map_fn: MapFn, parent: &'a mut Parent) -> Self

Create a new sublist that maps a list of subfunction errors to the parent error

map_fn is a function that accepts an ErrorList<E> and returns a ParentErr, which is then pushed into the parent’s error list.

It is recommended use WriteErrorList::sublist instead of this.

Methods from Deref<Target = ErrorList<E>>

pub fn is_empty(&self) -> bool

Returns whether the error list is empty

pub fn len(&self) -> usize

Return the length of the error list

pub fn iter<'a>(&'a self) -> impl Iterator<Item = &'a E>

where E: 'a,

Iterate the error list, returning immutable references

pub fn iter_mut<'a>(&'a mut self) -> impl Iterator<Item = &'a mut E>

where E: 'a,

Iterate the error list, returning mutable references

Trait Implementations

impl<'a, E, MapFn, Parent, ParentErr> Deref for Sublist<'a, E, MapFn, Parent, ParentErr>

where MapFn: FnOnce(ErrorList<E>) -> ParentErr, Parent: WriteErrorList<ParentErr>,

type Target = ErrorList<E>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a, E, MapFn, Parent, ParentErr> DerefMut for Sublist<'a, E, MapFn, Parent, ParentErr>

where MapFn: FnOnce(ErrorList<E>) -> ParentErr, Parent: WriteErrorList<ParentErr>,

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'a, E, MapFn, Parent, ParentErr> Drop for Sublist<'a, E, MapFn, Parent, ParentErr>

where MapFn: FnOnce(ErrorList<E>) -> ParentErr, Parent: WriteErrorList<ParentErr>,

fn drop(&mut self)

Executes the destructor for this type.

impl<'a, E, MapFn, Parent, ParentErr> WriteErrorList<E> for Sublist<'a, E, MapFn, Parent, ParentErr>

where MapFn: FnOnce(ErrorList<E>) -> ParentErr, Parent: WriteErrorList<ParentErr>,

fn push(&mut self, error: E)

Add an error to the list of errors

fn subwriter<'sub, SubMapFn, SubErr: 'sub>( &'sub mut self, map_fn: SubMapFn, ) -> impl WriteErrorList<SubErr> + 'sub

where SubMapFn: FnOnce(ErrorList<SubErr>) -> E + 'sub,

Create a new mapping error writer with this as its parent

fn sublist<SubMapFn, SubErr>( &mut self, map_fn: SubMapFn, ) -> Sublist<'_, SubErr, SubMapFn, Self, E>

where SubMapFn: FnOnce(ErrorList<SubErr>) -> E,

Start a new error list with this error list as its parent

fn finish(self)

Finish this error list