Struct combine::primitives::ParseError
[−]
[src]
pub struct ParseError<S: StreamOnce> { pub position: S::Position, pub errors: Vec<Error<S::Item, S::Range>>, }
Struct which hold information about an error that occured at a specific position.
Can hold multiple instances of Error
if more that one error occured in the same position.
Fields
position: S::Position
The position where the error occured
errors: Vec<Error<S::Item, S::Range>>
A vector containing specific information on what errors occured at position
. Usually
a fully formed message contains one Unexpected
error and one or more Expected
errors.
Message
and Other
may also appear (combine
never generates these errors on its own)
and may warrant custom handling.
Methods
impl<S: StreamOnce> ParseError<S>
[src]
fn new(position: S::Position, error: Error<S::Item, S::Range>) -> ParseError<S>
Constructs a new ParseError
which occured at position
.
fn empty(position: S::Position) -> ParseError<S>
Constructs an error with no other information than the position it occured at.
fn from_errors(position: S::Position,
errors: Vec<Error<S::Item, S::Range>>)
-> ParseError<S>
errors: Vec<Error<S::Item, S::Range>>)
-> ParseError<S>
Constructs a ParseError
with multiple causes.
fn end_of_input(position: S::Position) -> ParseError<S>
Constructs an end of input error. Should be returned by parsers which encounter end of input unexpectedly.
fn add_message<M>(&mut self, message: M) where M: Into<Info<S::Item, S::Range>>
: Use add_error(Error::Message())
instead
Adds a Message
error, taking care not to add duplicated errors.
fn add_error(&mut self, error: Error<S::Item, S::Range>)
Adds an error if error
does not exist in this ParseError
already (as determined byte
PartialEq
).
fn set_expected(&mut self, info: Info<S::Item, S::Range>)
Remvoes all Expected
errors in self
and adds info
instead.
fn merge(self, other: ParseError<S>) -> ParseError<S>
Merges two ParseError
s. If they exist at the same position the errors of other
are
added to self
(using add_error
to skip duplicates). If they are not at the same
position the error furthest ahead are returned, ignoring the other ParseError
.
impl<'s> ParseError<&'s str>
[src]
fn translate_position(self, initial_string: &'s str) -> ParseError<&'s str>
Converts the pointer-based position into an indexed position.
let text = "b"; let err = token('a').parse(text).unwrap_err(); assert_eq!(err.position, text.as_ptr() as usize); assert_eq!(err.translate_position(text).position, 0);
impl<'s, T: 's> ParseError<&'s [T]> where T: Clone + PartialEq
[src]
fn translate_position(self, initial_string: &'s [T]) -> ParseError<&'s [T]>
Converts the pointer-based position into an indexed position.
let text = b"b"; let err = token(b'a').parse(&text[..]).unwrap_err(); assert_eq!(err.position, text.as_ptr() as usize); assert_eq!(err.translate_position(text).position, 0);
Trait Implementations
impl<S> StdError for ParseError<S> where S: Stream,
S::Range: Display + Debug + Any,
S::Item: Display + Debug + Any,
S::Position: Display + Debug + Any
[src]
S::Range: Display + Debug + Any,
S::Item: Display + Debug + Any,
S::Position: Display + Debug + Any
fn description(&self) -> &str
A short description of the error. Read more
fn cause(&self) -> Option<&Error>
1.0.0
The lower-level cause of this error, if any. Read more
impl<S> PartialEq for ParseError<S> where S: Stream, S::Position: PartialEq
[src]
fn eq(&self, other: &ParseError<S>) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Rhs) -> bool
1.0.0
This method tests for !=
.
impl<S> Debug for ParseError<S> where S: Stream,
S::Range: Debug,
S::Item: Debug,
S::Position: Debug
[src]
S::Range: Debug,
S::Item: Debug,
S::Position: Debug
impl<S> Display for ParseError<S> where S: Stream,
S::Item: Display,
S::Range: Display,
S::Position: Display
[src]
S::Item: Display,
S::Range: Display,
S::Position: Display