Enum OptPort 

pub enum OptPort {
    Unset,
    Empty,
    Set(u16),
}

Available on crate feature net only.

The port component of an authority — tri-state.

RFC 3986 §3.2.3 port = *DIGIT permits the Empty form on the wire (example.com:). Most consumers treat it the same as Unset for dialing purposes (see as_u16); preserving the distinction keeps the wire bytes round-trippable through owned address types.

Variants

Unset

No :port suffix on the wire (example.com/path).

Empty

: present, no digits (example.com:/path).

Set(u16)

Explicit port number (example.com:8080/path).

Implementations

impl OptPort

pub const fn canonicalize(self) -> OptPort

Return the canonical presentation of this optional port.

RFC 3986 permits an empty port, but it is equivalent to an absent port for resolution and canonical rendering. Explicit ports are preserved; dropping a scheme’s default port requires the scheme and is handled by HostWithOptPort::without_default_port_for.

pub const fn as_u16(self) -> Option<u16>

Returns the port number, or None for both Unset and Empty. Use this when the wire distinction between “no colon” and “empty colon” doesn’t matter — e.g. dialing.

pub const fn is_explicit(self) -> bool

true for Empty and Set — the wire had a : after host.

pub const fn is_empty(self) -> bool

true only for Empty — : present with no digits.

pub const fn is_unset(self) -> bool

true for Unset — no : after host.

Trait Implementations

impl Clone for OptPort

fn clone(&self) -> OptPort

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for OptPort

impl Debug for OptPort

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

Formats the value using the given formatter.

impl Default for OptPort

fn default() -> OptPort

Returns the “default value” for a type.

impl Display for OptPort

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

Unset renders nothing; Empty renders :; Set(n) renders :n. Suitable for direct concatenation after a host.

impl Eq for OptPort

impl From<OptPort> for Option<u16>

fn from(p: OptPort) -> Option<u16>

Maps Set(n) → Some(n); both Unset and Empty map to None. The reverse direction can’t recover Empty.

impl From<Option<u16>> for OptPort

fn from(opt: Option<u16>) -> OptPort

Converts to this type from the input type.

impl From<u16> for OptPort

fn from(n: u16) -> OptPort

Converts to this type from the input type.

impl Hash for OptPort

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

where __H: Hasher,

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 Ord for OptPort

fn cmp(&self, other: &OptPort) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for OptPort

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for OptPort

fn partial_cmp(&self, other: &OptPort) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for OptPort