Struct dangerous::Invalid

pub struct Invalid { /* fields omitted */ }

Invalid contains no details around what went wrong other than a RetryRequirement if the error is not fatal.

This is the most performant and simplistic catch-all error, but it doesn't provide any context to debug problems well.

See crate::error for additional documentation around the error system.

Example

use dangerous::Invalid;

let error: Invalid = dangerous::input(b"").read_all(|r| {
    r.read_u8()
}).unwrap_err();

assert_eq!(
    error.to_string(),
    "invalid input: needs 1 byte more to continue processing",
);

Implementations

impl Invalid

pub fn fatal() -> Self

Create a fatal Invalid error.

Trait Implementations

impl Clone for Invalid

fn clone(&self) -> Invalid

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Invalid

impl Debug for Invalid

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

Formats the value using the given formatter.

impl Display for Invalid

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

Formats the value using the given formatter.

impl Error for Invalid

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

impl<'i, S> From<Expected<'i, S>> for Invalid where
    S: ContextStack, 

fn from(err: Expected<'i, S>) -> Self

Performs the conversion.

impl<'i> From<ExpectedLength<'i>> for Invalid

fn from(err: ExpectedLength<'i>) -> Self

Performs the conversion.

impl<'i> From<ExpectedValid<'i>> for Invalid

fn from(err: ExpectedValid<'i>) -> Self

Performs the conversion.

impl<'i> From<ExpectedValue<'i>> for Invalid

fn from(err: ExpectedValue<'i>) -> Self

Performs the conversion.

impl From<Option<RetryRequirement>> for Invalid

fn from(retry_requirement: Option<RetryRequirement>) -> Self

Performs the conversion.

impl<'i> FromContext<'i> for Invalid

fn from_context<C>(self, _input: &'i Input, _context: C) -> Self where
    C: Context, 

Return Self with context.

impl PartialEq<Invalid> for Invalid

fn eq(&self, other: &Invalid) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Invalid) -> bool

This method tests for !=.

impl StructuralPartialEq for Invalid

impl ToRetryRequirement for Invalid

fn to_retry_requirement(&self) -> Option<RetryRequirement>

Returns the requirement, if applicable, to retry processing the Input.