Struct Url 

pub struct Url<'a> { /* private fields */ }

A parsed URL record backed by its WHATWG serialization (href).

Component boundaries are u32 byte offsets into Self::as_str. Absent optional markers use the sentinel Url::NONE (u32::MAX).

When the input is already in canonical form, Backing::Borrowed avoids heap allocation entirely.

Implementations

impl<'a> Url<'a>

pub const NONE: u32 = u32::MAX

Sentinel: component marker absent.

pub const NO_PORT: u32 = u32::MAX

Sentinel: no explicit port.

pub fn blank() -> Url<'static>

Empty placeholder (mostly for tests / incremental builders).

pub fn into_owned(self) -> Url<'static>

Detach from the input lifetime by owning the serialization.

pub fn parse(input: &'a str) -> Result<Self, ParseError>

Parse input according to the WHATWG basic URL parser with no base URL.

Errors

Returns ParseError::Failure on WHATWG failure, or ParseError::InputTooLong when the input cannot be indexed by u32.

pub fn parse_with_base( input: &'a str, base: Option<&Url<'_>>, ) -> Result<Self, ParseError>

Parse input against an optional absolute base URL.

Errors

See Url::parse.

pub const fn backing(&self) -> &Backing<'a>

The serialization backing (borrowed or owned).

pub fn as_str(&self) -> &str

The full serialization (WHATWG href).

pub const fn flags(&self) -> UrlFlags

Parser flags for this record.

pub const fn scheme_range(&self) -> Range<usize>

pub fn scheme(&self) -> &str

Scheme without trailing :.

pub fn protocol(&self) -> &str

WHATWG / WPT protocol getter (scheme + ':').

pub fn has_host(&self) -> bool

pub fn host(&self) -> Option<&str>

Host serialization without port (None when host is null).

pub fn username(&self) -> &str

Username component (percent-encoded), or "".

pub fn password(&self) -> &str

Password component, or "" when the password slot is absent.

pub const fn port_u16(&self) -> Option<u16>

pub fn port_str(&self) -> String

WHATWG / WPT port getter: decimal string, or "" when null.

pub fn hostname(&self) -> &str

WHATWG / WPT hostname getter (empty string when host is null).

pub fn host_with_port(&self) -> &str

WHATWG / WPT host getter: hostname, plus ":" port when port is non-null.

pub fn path(&self) -> &str

Path / opaque path serialization.

pub fn pathname(&self) -> &str

Alias for Self::path matching the WPT pathname attribute.

pub fn query(&self) -> Option<&str>

Query without leading ?, or None when null.

pub fn search(&self) -> &str

WHATWG / WPT search getter ("" or "?" + query).

pub fn fragment(&self) -> Option<&str>

Fragment without leading #, or None when null.

pub fn hash(&self) -> &str

WHATWG / WPT hash getter ("" or "#" + fragment).

pub fn href(&self) -> &str

Serialize this URL record (WHATWG / WPT href).

pub fn percent_decode(raw: &str) -> Cow<'_, str>

Percent-decode raw, allocating only when decoding changes the bytes.

Trait Implementations

impl<'a> Clone for Url<'a>

fn clone(&self) -> Url<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Url<'_>

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

Formats the value using the given formatter.

impl Display for Url<'_>

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

Formats the value using the given formatter.

impl Eq for Url<'_>

impl PartialEq for Url<'_>

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

Equality operator ==.

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

Inequality operator !=.