pub struct Error<R> {
pub variant: ErrorVariant<R>,
pub location: InputLocation,
pub line_col: LineColLocation,
/* private fields */
}
Expand description
Parse-related error type.
Fields§
§variant: ErrorVariant<R>
Variant of the error
location: InputLocation
Location within the input string
line_col: LineColLocation
Line/column within the input string
Implementations§
Source§impl<R: RuleType> Error<R>
impl<R: RuleType> Error<R>
Sourcepub fn new_from_pos(variant: ErrorVariant<R>, pos: Position<'_>) -> Error<R>
pub fn new_from_pos(variant: ErrorVariant<R>, pos: Position<'_>) -> Error<R>
Creates Error
from ErrorVariant
and Position
.
§Examples
let error = Error::new_from_pos(
ErrorVariant::ParsingError {
positives: vec![Rule::open_paren],
negatives: vec![Rule::closed_paren],
},
pos
);
println!("{}", error);
Sourcepub fn new_from_span(variant: ErrorVariant<R>, span: Span<'_>) -> Error<R>
pub fn new_from_span(variant: ErrorVariant<R>, span: Span<'_>) -> Error<R>
Creates Error
from ErrorVariant
and Span
.
§Examples
let error = Error::new_from_span(
ErrorVariant::ParsingError {
positives: vec![Rule::open_paren],
negatives: vec![Rule::closed_paren],
},
span
);
println!("{}", error);
Sourcepub fn with_path(self, path: &str) -> Error<R>
pub fn with_path(self, path: &str) -> Error<R>
Returns Error
variant with path
which is shown when formatted with Display
.
§Examples
Error::new_from_pos(
ErrorVariant::ParsingError {
positives: vec![Rule::open_paren],
negatives: vec![Rule::closed_paren],
},
pos
).with_path("file.rs");
Sourcepub fn path(&self) -> Option<&str>
pub fn path(&self) -> Option<&str>
Returns the path set using Error::with_path()
.
§Examples
let error = error.with_path("file.rs");
assert_eq!(Some("file.rs"), error.path());
Sourcepub fn renamed_rules<F>(self, f: F) -> Error<R>
pub fn renamed_rules<F>(self, f: F) -> Error<R>
Renames all Rule
s if this is a ParsingError
. It does nothing when called on a
CustomError
.
Useful in order to rename verbose rules or have detailed per-Rule
formatting.
§Examples
Error::new_from_pos(
ErrorVariant::ParsingError {
positives: vec![Rule::open_paren],
negatives: vec![Rule::closed_paren],
},
pos
).renamed_rules(|rule| {
match *rule {
Rule::open_paren => "(".to_owned(),
Rule::closed_paren => "closed paren".to_owned()
}
});
Sourcepub fn parse_attempts(&self) -> Option<ParseAttempts<R>>
pub fn parse_attempts(&self) -> Option<ParseAttempts<R>>
Get detailed information about errored rules sequence.
Returns Some(results)
only for ParsingError
.
Sourcepub fn parse_attempts_error(
&self,
input: &str,
rule_to_message: &RuleToMessageFn<R>,
is_whitespace: &IsWhitespaceFn,
) -> Option<Error<R>>
pub fn parse_attempts_error( &self, input: &str, rule_to_message: &RuleToMessageFn<R>, is_whitespace: &IsWhitespaceFn, ) -> Option<Error<R>>
Get error message based on parsing attempts.
Returns None
in case self parse_attempts
is None
.
Trait Implementations§
Source§impl<R> Error for Error<R>
impl<R> Error for Error<R>
1.30.0 · Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
👎Deprecated since 1.42.0: use the Display impl or to_string()
impl<R: Eq> Eq for Error<R>
impl<R> StructuralPartialEq for Error<R>
Auto Trait Implementations§
impl<R> Freeze for Error<R>
impl<R> RefUnwindSafe for Error<R>where
R: RefUnwindSafe,
impl<R> Send for Error<R>where
R: Send,
impl<R> Sync for Error<R>where
R: Sync,
impl<R> Unpin for Error<R>where
R: Unpin,
impl<R> UnwindSafe for Error<R>where
R: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
🔬This is a nightly-only experimental API. (
clone_to_uninit
)