Struct ErrorReport 

pub struct ErrorReport { /* private fields */ }

Ordered failures collected while authoring or compiling one value.

A report is the fatal counterpart of Diagnostics, which carries the non-fatal warnings of the same step. Error always describes exactly one failure; fluent builders retain their deferred failures here and return the whole report from build.

At most 1024 errors are kept; later ones are dropped. Reports passed to ErrorReport::record are flattened so callers see individual failures. Converting a report with ? into Error keeps it reachable through Error::report.

use motion_core::{Error, ErrorReport};
let mut report = ErrorReport::default();
report.record(Error::from(std::io::Error::other("disk failure")));
assert_eq!(report.len(), 1);

Implementations

impl ErrorReport

pub fn record(&mut self, error: Error)

Appends one failure, flattening nested reports, until the bound is reached.

pub fn record_shared(&mut self, error: Arc<Error>)

Appends an already shared failure without flattening it.

pub fn errors(&self) -> &[Arc<Error>]

Retained failures in insertion order.

pub fn first(&self) -> Option<&Arc<Error>>

First retained failure, which classifies the report.

pub fn len(&self) -> usize

Number of retained failures.

pub fn is_empty(&self) -> bool

Whether no failure was recorded.

pub fn into_vec(self) -> Vec<Arc<Error>>

Takes the retained failures.

pub fn map(self, map: impl FnMut(Arc<Error>) -> Arc<Error>) -> Self

Replaces every retained failure with map of it, preserving order.

Trait Implementations

impl Clone for ErrorReport

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorReport

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

Formats the value using the given formatter.

impl Default for ErrorReport

fn default() -> Self

Returns the “default value” for a type.

impl Display for ErrorReport

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

Formats the value using the given formatter.

impl Error for ErrorReport

fn source(&self) -> Option<&(dyn StdError + '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<Box<dyn Error + Sync + Send>> for ErrorReport

fn from(error: BoxedError) -> Self

Converts to this type from the input type.

impl From<Error> for ErrorReport

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ErrorReport

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<ErrorReport> for Error

fn from(report: ErrorReport) -> Self

Converts to this type from the input type.

impl From<ValidationError> for ErrorReport

fn from(error: ValidationError) -> Self

Converts to this type from the input type.

impl IntoIterator for ErrorReport

type Item = Arc<Error>

The type of the elements being iterated over.

type IntoIter = IntoIter<Arc<Error>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a ErrorReport

type Item = &'a Arc<Error>

The type of the elements being iterated over.

type IntoIter = Iter<'a, Arc<Error>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.