Struct Problems 

pub struct Problems {
    pub problems: ThinVec<Problem>,
    pub critical_error_types: HashSet<TypeId>,
}

A simple wrapper for a vector of Problem.

Useful for accumulating problems, as it implements ProblemReceiver. By default it will swallow all problems into its vector. However, it can also be configured to fail fast on specific error types by calling handle_type_as_critical before use.

After use, you may want to call check to fail if there were problems.

Note that this type implements Error and as such can be used in the causation chain of a Problem. This can be thought of as “packing” many problems into one. It can then be “unpacked” via Problem::into_problems.

Fields

problems: ThinVec<Problem>

Problems.

critical_error_types: HashSet<TypeId>

Critical error type IDs.

Implementations

impl Problems

pub fn with_capacity(capacity: usize) -> Self

Constructor.

pub fn is_empty(&self) -> bool

True if there are no problems.

pub fn count(&self) -> usize

The number of problems.

pub fn iter(&self) -> Iter<'_, Problem>

Iterate problems.

pub fn handle_type_as_critical<ErrorT>(&mut self)

where ErrorT: Any + Error,

Marks a top error type as critical.

pub fn is_critical(&self, problem: &Problem) -> bool

True if the problem’s top error is critical.

pub fn is_error_critical(&self, error: &CapturedError) -> bool

True if the error is critical.

pub fn add<ProblemT>(&mut self, problem: ProblemT)

where ProblemT: Into<Problem>,

Add a problem.

pub fn check(self) -> Result<Self, Self>

Fails with self if there is at least one problem.

Other returns self.

pub fn into_unique(self) -> Self

Into unique problems.

Equality is tested for using the first CauseEquality or CauseComparison found in each problem.

pub fn iter_unique(self) -> impl Iterator<Item = Problem>

Iterate unique problems.

Equality is tested for using the first CauseEquality or CauseComparison found in each problem.

pub fn iter_unique_refs<'this>( &'this self, ) -> impl Iterator<Item = &'this Problem>

Iterate unique problems.

Equality is tested for using the first CauseEquality or CauseComparison found in each problem.

Trait Implementations

impl Debug for Problems

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

Formats the value using the given formatter.

impl Default for Problems

fn default() -> Problems

Returns the “default value” for a type.

impl Display for Problems

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

Formats the value using the given formatter.

impl Error for Problems

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<Problem> for Problems

fn from(problem: Problem) -> Self

Converts to this type from the input type.

impl From<ThinVec<Problem>> for Problems

fn from(problems: ThinVec<Problem>) -> Self

Converts to this type from the input type.

impl<ErrorT> FromIterator<ErrorT> for Problems

where ErrorT: 'static + Error + Send + Sync,

fn from_iter<IntoIteratorT>(iterator: IntoIteratorT) -> Self

where IntoIteratorT: IntoIterator<Item = ErrorT>,

Creates a value from an iterator.

impl FromIterator<Problem> for Problems

fn from_iter<IntoIteratorT>(iterator: IntoIteratorT) -> Self

where IntoIteratorT: IntoIterator<Item = Problem>,

Creates a value from an iterator.

impl<'this> IntoIterator for &'this Problems

type Item = &'this Problem

The type of the elements being iterated over.

type IntoIter = Iter<'this, Problem>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for Problems

Available on crate feature thin-vec only.

type Item = Problem

The type of the elements being iterated over.

type IntoIter = IntoIter<Problem>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl ProblemReceiver for Problems

fn give(&mut self, problem: Problem) -> Result<(), Problem>

Gives a problem to the receiver.