pub trait ToSocketAddrs {
type Iter: Iterator<Item = SocketAddr>;
// Required method
fn to_socket_addrs(&self) -> Result<Self::Iter, Error>;
}
Expand description
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)
:&str
should be either a string representation of anIpAddr
address as expected byFromStr
implementation or a host name.u16
is the port number. -
&str
: the string should be either a string representation of aSocketAddr
as expected by itsFromStr
implementation or a string like<host_name>:<port>
pair where<port>
is au16
value.
This trait allows constructing network objects like TcpStream
or
UdpSocket
easily with values of various types for the b