Trait ToSocketAddrs

pub trait ToSocketAddrs {
    type Iter: Iterator<Item = SocketAddr>;

    // Required method
    fn to_socket_addrs(&self) -> Result<Self::Iter>;
}

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, (IpAddr, u16), (Ipv4Addr, u16): to_socket_addrs constructs a SocketAddr trivially.

• (&str, u16): &str should be either a string representation of an IpAddr address as expected by FromStr implementation or a host name. u16 is the port number.

• &str: the string should be either a string representation of a SocketAddr as expected by its FromStr implementation or a string like <host_name>:<port> pair where <port> is a u16 value.

Required Associated Types

type Iter: Iterator<Item = SocketAddr>

Returned iterator over socket addresses which this type may correspond to.

Required Methods

fn to_socket_addrs(&self) -> Result<Self::Iter>

Converts this object to an iterator of resolved SocketAddrs.

Implementations on Foreign Types

impl ToSocketAddrs for (&str, u16)

Available on crate feature net only.

type Iter = IntoIter<SocketAddr>

fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>

impl ToSocketAddrs for (IpAddr, u16)

type Iter = IntoIter<SocketAddr>

fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>

impl ToSocketAddrs for (String, u16)

Available on crate feature net only.

type Iter = IntoIter<SocketAddr>

fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>

impl ToSocketAddrs for (Ipv4Addr, u16)

type Iter = IntoIter<SocketAddr>

fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>

impl ToSocketAddrs for str

Available on crate feature net only.

type Iter = IntoIter<SocketAddr>

fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>

impl ToSocketAddrs for String

Available on crate feature net only.

type Iter = IntoIter<SocketAddr>

fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>>

impl<'a> ToSocketAddrs for &'a [SocketAddr]

type Iter = Cloned<Iter<'a, SocketAddr>>

fn to_socket_addrs(&self) -> Result<Self::Iter>

impl<T: ToSocketAddrs + ?Sized> ToSocketAddrs for &T

type Iter = <T as ToSocketAddrs>::Iter

fn to_socket_addrs(&self) -> Result<T::Iter>

Implementors

impl ToSocketAddrs for SocketAddr

type Iter = IntoIter<SocketAddr>

impl ToSocketAddrs for SocketAddrV4

type Iter = IntoIter<SocketAddr>