Enum UriError 

pub enum UriError {
    InvalidComponent {
        component: Component,
        cause: ParseError,
    },
    ComponentConversion {
        component: Component,
        cause: Box<dyn Error + Send + Sync>,
    },
    AsteriskOperation,
}

Available on crate feature net only.

Reasons an operation on an already-parsed Uri can fail.

Distinct from ParseError because mutation has different diagnostic needs from parsing — when a setter fails, callers want to know which component they were touching, even if the underlying cause didn’t tag it (e.g. a control-char rejection during set_path is more useful as InvalidComponent { component: Path, cause: ControlCharInUri } than as a bare ControlCharInUri).

Variants

InvalidComponent

A setter received an input that fails component validation. The cause is the underlying parse-level failure.

Fields

component: Component

Which component the setter targeted.

cause: ParseError

Underlying parse-level cause.

ComponentConversion

A typed-input conversion into a URI component failed before the value reached the setter. The boxed cause is whatever the upstream TryInto impl returned — typically from Host::try_from or Domain::try_from for inputs like raw UTF-8 hosts when the idna feature is disabled.

Distinct from UriError::InvalidComponent because the failure originates outside the URI parser, so the cause cannot always be expressed as a ParseError.

Fields

component: Component

Which component the setter targeted.

cause: Box<dyn Error + Send + Sync>

Underlying conversion cause (boxed because typed input converters live across crate boundaries).

AsteriskOperation

An operation was attempted that is meaningless for the asterisk-form URI (e.g. iterating path segments of *). Most setters auto-upgrade asterisk to a reference; the few that cannot return this error.

Trait Implementations

impl Debug for UriError

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

Formats the value using the given formatter.

impl Display for UriError

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

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.