Struct ErrorSet

pub struct ErrorSet { /* private fields */ }

A set of errors found in a human-readable encoding of a Simplicity program.

Implementations

impl ErrorSet

pub fn new() -> Self

Constructs a new empty error set.

pub fn first_error(&self) -> Option<(Option<Position>, &Error)>

Returns the first (and presumably most important) error in the set, if it is non-empty, along with its position.

pub fn iter(&self) -> impl Iterator<Item = &Error>

Return an iterator over the errors in the error set.

pub fn single<P: Into<Position>, E: Into<Error>>(position: P, err: E) -> Self

Constructs a new error set with a single error in it.

pub fn single_no_position<E: Into<Error>>(err: E) -> Self

Constructs a new error set with a single error in it.

pub fn add<P: Into<Position>, E: Into<Error>>(&mut self, position: P, err: E)

Adds an error to the error set.

pub fn add_no_position<E: Into<Error>>(&mut self, err: E)

Adds an error to the error set.

pub fn merge(&mut self, other: &Self)

Merges another set of errors into the current set.

Panics

Panics if the two sets have different contexts attached.

pub fn add_context(&mut self, s: Arc<str>)

Attaches the input code to the error set, so that error messages can include line numbers etc.

Panics

Panics if it is called twice on the same error set. You should call this once with the complete input code.

pub fn is_empty(&self) -> bool

Returns a boolean indicating whether the set is empty.

pub fn len(&self) -> usize

Returns the number of errors currently in the set.

pub fn into_result<T>(self, ok: T) -> Result<T, Self>

Converts the error set into a result.

If the set is empty, returns Ok with the given value. Otherwise returns Err with itself.

pub fn into_result_with<T, F: FnOnce() -> T>(self, okfn: F) -> Result<T, Self>

Converts the error set into a result.

If the set is empty, returns Ok with the result of calling the given closure. Otherwise returns Err with itself.

Trait Implementations

impl Clone for ErrorSet

fn clone(&self) -> ErrorSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorSet

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

Formats the value using the given formatter.

impl Default for ErrorSet

fn default() -> ErrorSet

Returns the “default value” for a type.

impl Display for ErrorSet

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

Formats the value using the given formatter.

impl Error for ErrorSet

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

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

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 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<LexerError> for ErrorSet

fn from(e: LexerError) -> Self

Converts to this type from the input type.

impl<T> From<ParseError<T>> for ErrorSet

fn from(e: ParseError<T>) -> Self

Converts to this type from the input type.