[−][src]Trait addr_hal::ToSocketAddrs
A trait for objects which can be converted or resolved to one or more
SocketAddr
values.
This trait is used for generic address resolution when constructing network objects. By default it is implemented for the following types:
-
SocketAddr
: [to_socket_addrs
] is the identity function. -
SocketAddrV4
,SocketAddrV6
,(
IpAddr
,
u16
)
,(
Ipv4Addr
,
u16
)
,(
Ipv6Addr
,
u16
)
: [to_socket_addrs
] constructs aSocketAddr
trivially. -
(
[&str
],
u16
)
: the string should be either a string representation of anIpAddr
address as expected by [FromStr
] implementation or a host name. -
[
&str
]: the string should be either a string representation of aSocketAddr
as expected by its [FromStr
] implementation or a string like<host_name>:<port>
pair where<port>
is au16
value.
Associated Types
type Iter: Iterator<Item = SocketAddr<SA4, SA6>>
Returned iterator over socket addresses which this type may correspond to.
Required methods
fn to_socket_addrs(&self) -> Result<Self::Iter, ToSocketAddrError>
Converts this object to an iterator of resolved SocketAddr
s.
The returned iterator may not actually yield any values depending on the outcome of any resolution performed.
Note that this function may block the current thread while resolution is performed.
Implementors
impl<SA4: SocketAddressV4, SA6: SocketAddressV6> ToSocketAddrs<SA4, SA6> for (IpAddr<SA4::IpAddress, SA6::IpAddress>, u16)
[src]
type Iter = IntoIter<SocketAddr<SA4, SA6>>
fn to_socket_addrs(
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
[src]
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
impl<SA4: SocketAddressV4, SA6: SocketAddressV6> ToSocketAddrs<SA4, SA6> for (Ipv4Addr<SA4::IpAddress>, u16)
[src]
type Iter = IntoIter<SocketAddr<SA4, SA6>>
fn to_socket_addrs(
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
[src]
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
impl<SA4: SocketAddressV4, SA6: SocketAddressV6> ToSocketAddrs<SA4, SA6> for (Ipv6Addr<SA6::IpAddress>, u16)
[src]
type Iter = IntoIter<SocketAddr<SA4, SA6>>
fn to_socket_addrs(
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
[src]
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
impl<SA4: SocketAddressV4, SA6: SocketAddressV6> ToSocketAddrs<SA4, SA6> for SocketAddr<SA4, SA6>
[src]
type Iter = IntoIter<SocketAddr<SA4, SA6>>
fn to_socket_addrs(
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
[src]
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
impl<SA4: SocketAddressV4, SA6: SocketAddressV6> ToSocketAddrs<SA4, SA6> for SocketAddrV4<SA4>
[src]
type Iter = IntoIter<SocketAddr<SA4, SA6>>
fn to_socket_addrs(
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
[src]
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
impl<SA4: SocketAddressV4, SA6: SocketAddressV6> ToSocketAddrs<SA4, SA6> for SocketAddrV6<SA6>
[src]
type Iter = IntoIter<SocketAddr<SA4, SA6>>
fn to_socket_addrs(
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>
[src]
&self
) -> Result<IntoIter<SocketAddr<SA4, SA6>>, ToSocketAddrError>