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 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 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 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

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

impl Eq for OptPort

impl StructuralPartialEq for OptPort