Struct net_types::LinkLocalAddr

pub struct LinkLocalAddr<A>(/* private fields */);

An address which is guaranteed to be link-local.

LinkLocalAddr wraps an address of type A and guarantees that it is a link-local address. Note that this guarantee is contingent on a correct implementation of the LinkLocalAddress trait. Since that trait is not unsafe, unsafe code may NOT rely on this guarantee for its soundness.

Implementations

impl<A: LinkLocalAddress> LinkLocalAddr<A>

pub fn new(addr: A) -> Option<LinkLocalAddr<A>>

Constructs a new LinkLocalAddr.

new returns None if !addr.is_link_local().

pub fn from_witness<W: Witness<A>>(addr: W) -> Option<LinkLocalAddr<A>>

Constructs a new LinkLocalAddr from a witness type.

from_witness(witness) is equivalent to new(witness.into_addr()).

impl<A> LinkLocalAddr<A>

pub const unsafe fn new_unchecked(addr: A) -> LinkLocalAddr<A>

Constructs a new LinkLocalAddr without checking to see if addr is actually link-local.

Safety

It is up to the caller to make sure that addr is link-local to avoid breaking the guarantees of LinkLocalAddr. See LinkLocalAddr for more details.

impl<A: LinkLocalAddress + SpecifiedAddress> LinkLocalAddr<A>

pub fn into_specified(self) -> SpecifiedAddr<A>

Converts this LinkLocalAddr into a SpecifiedAddr.

LinkLocalAddress::is_link_local implies SpecifiedAddress::is_specified, so all LinkLocalAddrs are guaranteed to be specified, so this conversion is infallible.

Trait Implementations

impl<A: LinkLocalAddress> AsRef<A> for LinkLocalAddr<A>

fn as_ref(&self) -> &A

Converts this type into a shared reference of the (usually inferred) input type.

impl<A: LinkLocalAddress + BroadcastAddress> AsRef<A> for LinkLocalAddr<BroadcastAddr<A>>

fn as_ref(&self) -> &A

Converts this type into a shared reference of the (usually inferred) input type.

impl<A: LinkLocalAddress + MulticastAddress> AsRef<A> for LinkLocalAddr<MulticastAddr<A>>

fn as_ref(&self) -> &A

Converts this type into a shared reference of the (usually inferred) input type.

impl<A: LinkLocalAddress + MappedAddress> AsRef<A> for LinkLocalAddr<NonMappedAddr<A>>

fn as_ref(&self) -> &A

Converts this type into a shared reference of the (usually inferred) input type.

impl<A: LinkLocalAddress + UnicastAddress> AsRef<A> for LinkLocalAddr<UnicastAddr<A>>

fn as_ref(&self) -> &A

Converts this type into a shared reference of the (usually inferred) input type.

impl<A: LinkLocalAddress> AsRef<LinkLocalAddr<A>> for LinkLocalAddr<A>

fn as_ref(&self) -> &LinkLocalAddr<A>

Converts this type into a shared reference of the (usually inferred) input type.

impl<A: BroadcastAddress> BroadcastAddress for LinkLocalAddr<A>

fn is_broadcast(&self) -> bool

Is this a broadcast address?

impl<A: Clone> Clone for LinkLocalAddr<A>

fn clone(&self) -> LinkLocalAddr<A>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<A: Debug> Debug for LinkLocalAddr<A>

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

Formats the value using the given formatter.

impl<A: LinkLocalAddress> Deref for LinkLocalAddr<A>

type Target = A

The resulting type after dereferencing.

fn deref(&self) -> &A

Dereferences the value.

impl<A: Display> Display for LinkLocalAddr<A>

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

Formats the value using the given formatter.

impl From<IpAddr<LinkLocalAddr<Ipv4Addr>, LinkLocalAddr<Ipv6Addr>>> for LinkLocalAddr<IpAddr>

fn from( addr: IpAddr<LinkLocalAddr<Ipv4Addr>, LinkLocalAddr<Ipv6Addr>>, ) -> LinkLocalAddr<IpAddr>

Converts to this type from the input type.

impl<A: IpAddress> From<LinkLocalAddr<A>> for IpAddr<LinkLocalAddr<Ipv4Addr>, LinkLocalAddr<Ipv6Addr>>

fn from( addr: LinkLocalAddr<A>, ) -> IpAddr<LinkLocalAddr<Ipv4Addr>, LinkLocalAddr<Ipv6Addr>>

Converts to this type from the input type.

impl<A: Into<Ipv4Addr> + LinkLocalAddress + Copy> From<LinkLocalAddr<A>> for Ipv4Addr

fn from(addr: LinkLocalAddr<A>) -> Ipv4Addr

Converts to this type from the input type.

impl<A: Into<Ipv6Addr> + LinkLocalAddress + Copy> From<LinkLocalAddr<A>> for Ipv6Addr

fn from(addr: LinkLocalAddr<A>) -> Ipv6Addr

Converts to this type from the input type.

impl<A: IpAddress> From<LinkLocalAddr<A>> for LinkLocalAddr<IpAddr>

fn from(addr: LinkLocalAddr<A>) -> LinkLocalAddr<IpAddr>

Converts to this type from the input type.

impl<A: LinkLocalAddress + SpecifiedAddress> From<LinkLocalAddr<A>> for SpecifiedAddr<A>

fn from(addr: LinkLocalAddr<A>) -> SpecifiedAddr<A>

Converts to this type from the input type.

impl<A: LinkLocalAddress + BroadcastAddress + SpecifiedAddress> From<LinkLocalAddr<BroadcastAddr<A>>> for SpecifiedAddr<A>

fn from(addr: LinkLocalAddr<BroadcastAddr<A>>) -> SpecifiedAddr<A>

Converts to this type from the input type.

impl From<LinkLocalAddr<IpAddr>> for IpAddr<LinkLocalAddr<Ipv4Addr>, LinkLocalAddr<Ipv6Addr>>

fn from( addr: LinkLocalAddr<IpAddr>, ) -> IpAddr<LinkLocalAddr<Ipv4Addr>, LinkLocalAddr<Ipv6Addr>>

Converts to this type from the input type.

impl<A: LinkLocalAddress + MulticastAddress + SpecifiedAddress> From<LinkLocalAddr<MulticastAddr<A>>> for SpecifiedAddr<A>

fn from(addr: LinkLocalAddr<MulticastAddr<A>>) -> SpecifiedAddr<A>

Converts to this type from the input type.

impl<A: LinkLocalAddress + MappedAddress + SpecifiedAddress> From<LinkLocalAddr<NonMappedAddr<A>>> for SpecifiedAddr<A>

fn from(addr: LinkLocalAddr<NonMappedAddr<A>>) -> SpecifiedAddr<A>

Converts to this type from the input type.

impl<A: LinkLocalAddress + UnicastAddress + SpecifiedAddress> From<LinkLocalAddr<UnicastAddr<A>>> for SpecifiedAddr<A>

fn from(addr: LinkLocalAddr<UnicastAddr<A>>) -> SpecifiedAddr<A>

Converts to this type from the input type.

impl<A: Hash> Hash for LinkLocalAddr<A>

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 IpAddrWitness for LinkLocalAddr<IpAddr>

type V4 = LinkLocalAddr<Ipv4Addr>

The IPv4-specific version of Self.

type V6 = LinkLocalAddr<Ipv6Addr>

The IPv6-specific version of Self.

fn from_v4(addr: Self::V4) -> Self

Converts an IPv4-specific witness into a general witness.

fn from_v6(addr: Self::V6) -> Self

Converts an IPv6-specific witness into a general witness.

impl<A: IpAddress> IpAddressWitness<A> for LinkLocalAddr<A>

type IpAddrWitness = LinkLocalAddr<IpAddr>

The type-erased version of Self.

impl<A: MappedAddress> MappedAddress for LinkLocalAddr<A>

fn is_non_mapped(&self) -> bool

Is this a non-mapped address?

impl<A: MulticastAddress> MulticastAddress for LinkLocalAddr<A>

fn is_multicast(&self) -> bool

Is this a multicast address?

fn is_non_multicast(&self) -> bool

Is this a non-multicast address? The inverse of is_multicast().

impl<A: Ord> Ord for LinkLocalAddr<A>

fn cmp(&self, other: &LinkLocalAddr<A>) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl<A: PartialEq> PartialEq for LinkLocalAddr<A>

fn eq(&self, other: &LinkLocalAddr<A>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<A: PartialOrd> PartialOrd for LinkLocalAddr<A>

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl<A: ScopeableAddress> ScopeableAddress for LinkLocalAddr<A>

type Scope = <A as ScopeableAddress>::Scope

The type of all non-global scopes.

fn scope(&self) -> Self::Scope

The scope of this address.

impl<A: SpecifiedAddress> SpecifiedAddress for LinkLocalAddr<A>

fn is_specified(&self) -> bool

Is this a specified address?

impl<A: LinkLocalAddress> TransposableWitness<A> for LinkLocalAddr<A>

type Map<T> = LinkLocalAddr<T>

Maps the type wrapped by this witness.

impl<A: BroadcastAddress + LinkLocalAddress> TryFrom<BroadcastAddr<A>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: BroadcastAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl TryFrom<Ipv4Addr> for LinkLocalAddr<Ipv4Addr>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: Ipv4Addr) -> Result<LinkLocalAddr<Ipv4Addr>, ()>

Performs the conversion.

impl TryFrom<Ipv6Addr> for LinkLocalAddr<Ipv6Addr>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: Ipv6Addr) -> Result<LinkLocalAddr<Ipv6Addr>, ()>

Performs the conversion.

impl<A: LinkLocalAddress + BroadcastAddress> TryFrom<LinkLocalAddr<A>> for BroadcastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalAddr<A>) -> Result<BroadcastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalAddress + MulticastAddress> TryFrom<LinkLocalAddr<A>> for MulticastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalAddr<A>) -> Result<MulticastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalAddress + MappedAddress> TryFrom<LinkLocalAddr<A>> for NonMappedAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalAddr<A>) -> Result<NonMappedAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalAddress + UnicastAddress> TryFrom<LinkLocalAddr<A>> for UnicastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalAddr<A>) -> Result<UnicastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalBroadcastAddress + LinkLocalAddress> TryFrom<LinkLocalAddr<BroadcastAddr<A>>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalBroadcastAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalBroadcastAddress + LinkLocalMulticastAddress> TryFrom<LinkLocalAddr<BroadcastAddr<A>>> for LinkLocalMulticastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from( addr: LinkLocalBroadcastAddr<A>, ) -> Result<LinkLocalMulticastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalBroadcastAddress + LinkLocalUnicastAddress> TryFrom<LinkLocalAddr<BroadcastAddr<A>>> for LinkLocalUnicastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from( addr: LinkLocalBroadcastAddr<A>, ) -> Result<LinkLocalUnicastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalBroadcastAddress + MulticastAddress> TryFrom<LinkLocalAddr<BroadcastAddr<A>>> for MulticastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalBroadcastAddr<A>) -> Result<MulticastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalBroadcastAddress + UnicastAddress> TryFrom<LinkLocalAddr<BroadcastAddr<A>>> for UnicastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalBroadcastAddr<A>) -> Result<UnicastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalMulticastAddress + LinkLocalAddress> TryFrom<LinkLocalAddr<MulticastAddr<A>>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalMulticastAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalMulticastAddress + LinkLocalBroadcastAddress> TryFrom<LinkLocalAddr<MulticastAddr<A>>> for LinkLocalBroadcastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from( addr: LinkLocalMulticastAddr<A>, ) -> Result<LinkLocalBroadcastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalMulticastAddress + LinkLocalUnicastAddress> TryFrom<LinkLocalAddr<MulticastAddr<A>>> for LinkLocalUnicastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from( addr: LinkLocalMulticastAddr<A>, ) -> Result<LinkLocalUnicastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalMulticastAddress + MulticastAddress> TryFrom<LinkLocalAddr<MulticastAddr<A>>> for MulticastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalMulticastAddr<A>) -> Result<MulticastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalMulticastAddress + UnicastAddress> TryFrom<LinkLocalAddr<MulticastAddr<A>>> for UnicastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalMulticastAddr<A>) -> Result<UnicastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalUnicastAddress + LinkLocalAddress> TryFrom<LinkLocalAddr<UnicastAddr<A>>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalUnicastAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalUnicastAddress + LinkLocalBroadcastAddress> TryFrom<LinkLocalAddr<UnicastAddr<A>>> for LinkLocalBroadcastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from( addr: LinkLocalUnicastAddr<A>, ) -> Result<LinkLocalBroadcastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalUnicastAddress + LinkLocalMulticastAddress> TryFrom<LinkLocalAddr<UnicastAddr<A>>> for LinkLocalMulticastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from( addr: LinkLocalUnicastAddr<A>, ) -> Result<LinkLocalMulticastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalUnicastAddress + MulticastAddress> TryFrom<LinkLocalAddr<UnicastAddr<A>>> for MulticastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalUnicastAddr<A>) -> Result<MulticastAddr<A>, ()>

Performs the conversion.

impl<A: LinkLocalUnicastAddress + UnicastAddress> TryFrom<LinkLocalAddr<UnicastAddr<A>>> for UnicastAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: LinkLocalUnicastAddr<A>) -> Result<UnicastAddr<A>, ()>

Performs the conversion.

impl<A: MulticastAddress + LinkLocalAddress> TryFrom<MulticastAddr<A>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: MulticastAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: MappedAddress + LinkLocalAddress> TryFrom<NonMappedAddr<A>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: NonMappedAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: SpecifiedAddress + LinkLocalAddress> TryFrom<SpecifiedAddr<A>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: SpecifiedAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: UnicastAddress + LinkLocalAddress> TryFrom<UnicastAddr<A>> for LinkLocalAddr<A>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(addr: UnicastAddr<A>) -> Result<LinkLocalAddr<A>, ()>

Performs the conversion.

impl<A: UnicastAddress> UnicastAddress for LinkLocalAddr<A>

fn is_unicast(&self) -> bool

Is this a unicast address?

impl<A: LinkLocalAddress> Witness<A> for LinkLocalAddr<A>

fn new(addr: A) -> Option<LinkLocalAddr<A>>

Constructs a new witness type.

unsafe fn new_unchecked(addr: A) -> LinkLocalAddr<A>

Constructs a new witness type without checking to see if addr actually satisfies the required property.

fn into_addr(self) -> A

Consumes this witness and returns the contained A.

fn from_witness<W: Witness<A>>(addr: W) -> Option<Self>

Constructs a new witness type from an existing witness type.

fn transpose<T>(self) -> A::Map<Self::Map<T>>

where Self: TransposableWitness<A>, A: TransposableWitness<T>, Self::Map<T>: Witness<T>, A::Map<Self::Map<T>>: Witness<Self::Map<T>>,

Transposes this witness type with another witness type layered inside of it. (e.g. UnicastAddr<SpecifiedAddr> -> SpecifiedAddr<UnicastAddr>)

impl<A: LinkLocalAddress + BroadcastAddress> Witness<A> for LinkLocalAddr<BroadcastAddr<A>>

fn new(addr: A) -> Option<LinkLocalAddr<BroadcastAddr<A>>>

Constructs a new witness type.

unsafe fn new_unchecked(addr: A) -> LinkLocalAddr<BroadcastAddr<A>>

Constructs a new witness type without checking to see if addr actually satisfies the required property.

fn into_addr(self) -> A

Consumes this witness and returns the contained A.

fn from_witness<W: Witness<A>>(addr: W) -> Option<Self>

Constructs a new witness type from an existing witness type.

impl<A: LinkLocalAddress + MulticastAddress> Witness<A> for LinkLocalAddr<MulticastAddr<A>>

fn new(addr: A) -> Option<LinkLocalAddr<MulticastAddr<A>>>

Constructs a new witness type.

unsafe fn new_unchecked(addr: A) -> LinkLocalAddr<MulticastAddr<A>>

Constructs a new witness type without checking to see if addr actually satisfies the required property.

fn into_addr(self) -> A

Consumes this witness and returns the contained A.

fn from_witness<W: Witness<A>>(addr: W) -> Option<Self>

Constructs a new witness type from an existing witness type.

impl<A: LinkLocalAddress + MappedAddress> Witness<A> for LinkLocalAddr<NonMappedAddr<A>>

fn new(addr: A) -> Option<LinkLocalAddr<NonMappedAddr<A>>>

Constructs a new witness type.

unsafe fn new_unchecked(addr: A) -> LinkLocalAddr<NonMappedAddr<A>>

Constructs a new witness type without checking to see if addr actually satisfies the required property.

fn into_addr(self) -> A

Consumes this witness and returns the contained A.

fn from_witness<W: Witness<A>>(addr: W) -> Option<Self>

Constructs a new witness type from an existing witness type.

impl<A: LinkLocalAddress + UnicastAddress> Witness<A> for LinkLocalAddr<UnicastAddr<A>>

fn new(addr: A) -> Option<LinkLocalAddr<UnicastAddr<A>>>

Constructs a new witness type.

unsafe fn new_unchecked(addr: A) -> LinkLocalAddr<UnicastAddr<A>>

Constructs a new witness type without checking to see if addr actually satisfies the required property.

fn into_addr(self) -> A

Consumes this witness and returns the contained A.

fn from_witness<W: Witness<A>>(addr: W) -> Option<Self>

Constructs a new witness type from an existing witness type.

impl<A: Copy> Copy for LinkLocalAddr<A>

impl<A: Eq> Eq for LinkLocalAddr<A>

impl<A> StructuralPartialEq for LinkLocalAddr<A>