Enum URIError

#[non_exhaustive]
pub enum URIError {
    AbsolutePathStartsWithTwoSlashes,
    Authority(AuthorityError),
    Fragment(FragmentError),
    MissingPath,
    MissingScheme,
    NotURI,
    Path(PathError),
    Query(QueryError),
    Scheme(SchemeError),
}

An error representing an invalid URI.

Variants (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.

AbsolutePathStartsWithTwoSlashes

Represents the case when there is no authority, but the first path segment starts with "//". This is not allowed because it would be interpreted as an authority component.

This can only occur when using creation functions that act on individual parts (e.g. URI::from_parts).

Authority(AuthorityError)

The authority component of the relative reference was invalid.

Fragment(FragmentError)

The fragment component of the relative reference was invalid.

MissingPath

This error occurs when you do not specify a path component on the builder.

This can only occur when using URIBuilder.

MissingScheme

This error occurs when you do not specify a scheme component on the builder.

This can only occur when using URIBuilder.

NotURI

When parsing from some byte string source, if the source ends up being a relative reference, then it is obviously not a URI.

This can only occur when parsing from a byte string source.

Path(PathError)

The path component of the relative reference was invalid.

Query(QueryError)

The query component of the relative reference was invalid.

Scheme(SchemeError)

The scheme component of the relative reference was invalid.

Trait Implementations

impl Clone for URIError

fn clone(&self) -> URIError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for URIError

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

Formats the value using the given formatter.

impl Display for URIError

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

Formats the value using the given formatter.

impl Error for URIError

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 cause(&self) -> Option<&dyn Error>

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

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<AuthorityError> for URIError

fn from(value: AuthorityError) -> Self

Converts to this type from the input type.

impl From<FragmentError> for URIError

fn from(value: FragmentError) -> Self

Converts to this type from the input type.

impl From<Infallible> for URIError

fn from(_: Infallible) -> Self

Converts to this type from the input type.

impl From<PathError> for URIError

fn from(value: PathError) -> Self

Converts to this type from the input type.

impl From<QueryError> for URIError

fn from(value: QueryError) -> Self

Converts to this type from the input type.

impl From<SchemeError> for URIError

fn from(value: SchemeError) -> Self

Converts to this type from the input type.

impl Hash for URIError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for URIError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<URIReferenceError> for URIError

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: URIReferenceError) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for URIError

impl Eq for URIError

impl StructuralPartialEq for URIError