Enum tor_netdoc::Error[−][src]

#[non_exhaustive]
pub enum Error {
Show 32 variants
    Internal(Pos),
    MissingKeyword(Pos),
    TruncatedLine(Pos),
    BadKeyword(Pos),
    BadObjectBeginTag(Pos),
    BadObjectEndTag(Pos),
    BadObjectMismatchedTag(Pos),
    BadObjectBase64(Pos),
    DuplicateToken(&'static str, Pos),
    UnexpectedToken(&'static str, Pos),
    MissingToken(&'static str),
    MisplacedToken(&'static str, Pos),
    TooManyArguments(&'static str, Pos),
    TooFewArguments(&'static str, Pos),
    UnexpectedObject(&'static str, Pos),
    MissingObject(&'static str, Pos),
    WrongObject(Pos),
    MissingArgument(Pos),
    BadArgument(Pos, String),
    BadObjectVal(Pos, String),
    BadSignature(Pos),
    BadTorVersion(Pos),
    BadPolicy(Pos, PolicyError),
    Untimely(Pos, TimeValidityError),
    Undecodable(Pos, Error),
    BadDocumentVersion(u32),
    BadDocumentType,
    WrongStartingToken(String, Pos),
    WrongEndingToken(String, Pos),
    WrongSortOrder(Pos),
    InvalidLifetime,
    CannotBuild(&'static str),
}

Expand description

An error that occurred while parsing a directory object of some kind.

Variants (Non-exhaustive)

This enum is marked as non-exhaustive

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

`Internal(Pos)`

Tuple Fields

0: Pos

An internal error in the parser: these should never happen.

`MissingKeyword(Pos)`

Tuple Fields

0: Pos

An entry was found with no keyword.

`TruncatedLine(Pos)`

Tuple Fields

0: Pos

An entry was found with no newline at the end.

`BadKeyword(Pos)`

Tuple Fields

0: Pos

A bad string was found in the keyword position.

`BadObjectBeginTag(Pos)`

Tuple Fields

0: Pos

We found an ill-formed “BEGIN FOO” tag.

`BadObjectEndTag(Pos)`

Tuple Fields

0: Pos

We found an ill-formed “END FOO” tag.

`BadObjectMismatchedTag(Pos)`

Tuple Fields

0: Pos

We found a “BEGIN FOO” tag with an “END FOO” tag that didn’t match.

`BadObjectBase64(Pos)`

Tuple Fields

0: Pos

We found a base64 object with an invalid base64 encoding.

`DuplicateToken(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

The document is not supposed to contain more than one of some kind of entry, but we found one anyway.

`UnexpectedToken(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

The document is not supposed to contain any of some particular kind of entry, but we found one anyway.

`MissingToken(&'static str)`

Tuple Fields

0: &'static str

The document is supposed to contain any of some particular kind of entry, but we didn’t find one one anyway.

`MisplacedToken(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

The document was supposed to have one of these, but not where we found it.

`TooManyArguments(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

We found more arguments on an entry than it is allowed to have.

`TooFewArguments(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

We didn’t fine enough arguments for some entry.

`UnexpectedObject(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

We found an object attached to an entry that isn’t supposed to have one.

`MissingObject(&'static str, Pos)`

Tuple Fields

0: &'static str

1: Pos

An entry was supposed to have an object, but it didn’t.

`WrongObject(Pos)`

Tuple Fields

0: Pos

We found an object on an entry, but the type was wrong.

`MissingArgument(Pos)`

Tuple Fields

0: Pos

We tried to find an argument that we were sure would be there, but it wasn’t!

This error should never occur in correct code; it should be caught earlier by TooFewArguments.

`BadArgument(Pos, String)`

Tuple Fields

0: Pos

1: String

We found an argument that couldn’t be parsed.

`BadObjectVal(Pos, String)`

Tuple Fields

0: Pos

1: String

We found an object that couldn’t be parsed after it was decoded.

`BadSignature(Pos)`

Tuple Fields

0: Pos

There was some signature that we couldn’t validate.

`BadTorVersion(Pos)`

Tuple Fields

0: Pos

There was a tor version we couldn’t parse.

`BadPolicy(Pos, PolicyError)`

Tuple Fields

0: Pos

1: PolicyError

There was an ipv4 or ipv6 policy entry that we couldn’t parse.

`Untimely(Pos, TimeValidityError)`

Tuple Fields

0: Pos

1: TimeValidityError

An object was expired or not yet valid.

`Undecodable(Pos, Error)`

Tuple Fields

0: Pos

1: Error

An underlying byte sequence couldn’t be decoded.

`BadDocumentVersion(u32)`

Tuple Fields

0: u32

Versioned document with an unrecognized version.

`BadDocumentType`

Unexpected document type

`WrongStartingToken(String, Pos)`

Tuple Fields

0: String

1: Pos

Document or section started with wrong token

`WrongEndingToken(String, Pos)`

Tuple Fields

0: String

1: Pos

Document or section ended with wrong token

`WrongSortOrder(Pos)`

Tuple Fields

0: Pos

Items not sorted as expected

`InvalidLifetime`

A consensus lifetime was ill-formed.

`CannotBuild(&'static str)`

Tuple Fields

0: &'static str

We’re unable to finish building an object, for some reason.

Implementations

[src]

impl Error

[src]

pub fn within(self, s: &str) -> Error

Return a new error based on this one, with any byte-based position mapped to some line within a string.

[src]

pub fn at_pos(self, p: Pos) -> Error

Return a new error based on this one, with the position (if any) replaced by ‘p’.

[src]

pub fn or_at_pos(self, p: Pos) -> Error

Return a new error based on this one, with the position (if replaced by ‘p’ if it had no position before.

Trait Implementations

[src]

impl Clone for Error

[src]

fn clone(&self) -> Error

Returns a copy of the value. Read more

1.0.0[src]

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

Performs copy-assignment from source. Read more

[src]

impl Debug for Error

[src]

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

Formats the value using the given formatter. Read more

[src]

impl Display for Error

[src]

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

Formats the value using the given formatter. Read more

[src]

impl Error for Error

[src]

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

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

[src]

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

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

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

1.0.0[src]

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

[src]

impl From<AddrParseError> for Error

[src]

fn from(e: AddrParseError) -> Error

Performs the conversion.

[src]

impl From<Error> for Error

[src]

fn from(e: Error) -> Error

Performs the conversion.

[src]

impl From<Error> for Error

[src]

fn from(_e: Error) -> Error

Performs the conversion.

[src]

impl From<ParseIntError> for Error

[src]

fn from(e: ParseIntError) -> Error

Performs the conversion.

[src]

impl From<PolicyError> for Error

[src]

fn from(e: PolicyError) -> Error

Performs the conversion.

[src]

impl From<TimeValidityError> for Error

[src]

fn from(e: TimeValidityError) -> Error

Performs the conversion.

[src]

impl PartialEq<Error> for Error

[src]

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

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

[src]

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

This method tests for !=.

[src]

impl StructuralPartialEq for Error

Auto Trait Implementations

impl RefUnwindSafe for Error

impl Send for Error

impl Sync for Error

impl Unpin for Error

impl UnwindSafe for Error

Blanket Implementations

[src]

impl<T> Any for T where
T: 'static + ?Sized,

[src]

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

[src]

impl<T> Borrow<T> for T where
T: ?Sized,

[src]

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

[src]

impl<T> BorrowMut<T> for T where
T: ?Sized,

[src]

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

[src]

impl<T> From<T> for T

[src]

pub fn from(t: T) -> T

Performs the conversion.

[src]

impl<T, U> Into for T where
U: From<T>,

[src]

pub fn into(self) -> U

Performs the conversion.

[src]

impl<T> Same<T> for T

type Output = T

Should always be Self

[src]

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

[src]

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

[src]

pub fn clone_into(&self, target: &mut T)

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

Uses borrowed data to replace owned data, usually by cloning. Read more

[src]

impl<T> ToString for T where
T: Display + ?Sized,

[src]

pub default fn to_string(&self) -> String

Converts the given value to a String. Read more

[src]

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

[src]

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

[src]

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

[src]

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.