Enum std::net::SocketAddr

pub enum SocketAddr {
    V4(SocketAddrV4),
    V6(SocketAddrV6),
}

Internet 套接字地址，IPv4 或 IPv6。

Internet 套接字地址包含一个 IP 地址，一个 16 位端口号以及一些可能与版本有关的附加信息。 有关更多详细信息，请参见 SocketAddrV4 和 SocketAddrV6 的文档。

SocketAddr 实例的大小可能会因目标操作系统而异。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);

assert_eq!("127.0.0.1:8080".parse(), Ok(socket));
assert_eq!(socket.port(), 8080);
assert_eq!(socket.is_ipv4(), true);

Variants

V4(SocketAddrV4)

Tuple Fields

0: SocketAddrV4

IPv4 套接字地址。

V6(SocketAddrV6)

Tuple Fields

0: SocketAddrV6

IPv6 套接字地址。

Implementations

impl SocketAddr

pub fn new(ip: IpAddr, port: u16) -> SocketAddr

从 IP 地址 和端口号创建一个新的套接字地址。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
assert_eq!(socket.ip(), IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)));
assert_eq!(socket.port(), 8080);

pub fn ip(&self) -> IpAddr

返回与此套接字地址关联的 IP 地址。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
assert_eq!(socket.ip(), IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)));

pub fn set_ip(&mut self, new_ip: IpAddr)

更改与此套接字地址关联的 IP 地址。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let mut socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
socket.set_ip(IpAddr::V4(Ipv4Addr::new(10, 10, 0, 1)));
assert_eq!(socket.ip(), IpAddr::V4(Ipv4Addr::new(10, 10, 0, 1)));

pub fn port(&self) -> u16

返回与此套接字地址关联的端口号。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
assert_eq!(socket.port(), 8080);

pub fn set_port(&mut self, new_port: u16)

更改与此套接字地址关联的端口号。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let mut socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
socket.set_port(1025);
assert_eq!(socket.port(), 1025);

pub fn is_ipv4(&self) -> bool

如果此 SocketAddr 中的 IP 地址 是 IPv4 address，则返回 true，否则返回 false。

Examples

use std::net::{IpAddr, Ipv4Addr, SocketAddr};

let socket = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
assert_eq!(socket.is_ipv4(), true);
assert_eq!(socket.is_ipv6(), false);

pub fn is_ipv6(&self) -> bool

如果此 SocketAddr 中的 IP 地址 是 IPv6 address，则返回 true，否则返回 false。

Examples

use std::net::{IpAddr, Ipv6Addr, SocketAddr};

let socket = SocketAddr::new(IpAddr::V6(Ipv6Addr::new(0, 0, 0, 0, 0, 65535, 0, 1)), 8080);
assert_eq!(socket.is_ipv4(), false);
assert_eq!(socket.is_ipv6(), true);

Trait Implementations

impl Clone for SocketAddr

fn clone(&self) -> SocketAddr

返回值的副本。

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

从 source 执行复制分配。

impl Debug for SocketAddr

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

使用给定的格式化程序格式化该值。

impl Display for SocketAddr

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

使用给定的格式化程序格式化该值。

impl<I: Into<IpAddr>> From<(I, u16)> for SocketAddr

fn from(pieces: (I, u16)) -> SocketAddr

将元组结构体 (Into <IpAddr>，u16) 转换为 SocketAddr。

此转换为 IpAddr::V4 创建 SocketAddr::V4，并为 IpAddr::V6 创建 SocketAddr::V6。

u16 被视为新创建的 SocketAddr 的端口。

impl From<SocketAddrV4> for SocketAddr

fn from(sock4: SocketAddrV4) -> SocketAddr

将 SocketAddrV4 转换为 SocketAddr::V4。

impl From<SocketAddrV6> for SocketAddr

fn from(sock6: SocketAddrV6) -> SocketAddr

将 SocketAddrV6 转换为 SocketAddr::V6。

impl FromStr for SocketAddr

type Err = AddrParseError

可以从解析中返回的相关错误。

fn from_str(s: &str) -> Result<SocketAddr, AddrParseError>

解析字符串 s 以返回此类型的值。

impl Hash for SocketAddr

fn hash<__H: Hasher>(&self, state: &mut __H)

将该值输入给定的 Hasher。

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

将这种类型的切片送入给定的 Hasher 中。

impl Ord for SocketAddr

fn cmp(&self, other: &SocketAddr) -> Ordering

此方法返回 self 和 other 之间的 Ordering。

fn max(self, other: Self) -> Self

比较并返回两个值中的最大值。

fn min(self, other: Self) -> Self

比较并返回两个值中的最小值。

fn clamp(self, min: Self, max: Self) -> Self

将值限制在某个时间间隔内。

impl PartialEq<SocketAddr> for SocketAddr

fn eq(&self, other: &SocketAddr) -> bool

此方法测试 self 和 other 值是否相等，并由 == 使用。

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

此方法测试 !=。

impl PartialOrd<SocketAddr> for SocketAddr

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

如果存在，则此方法返回 self 和 other 值之间的顺序。

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

此方法测试的内容少于 (对于 self 和 other)，并且由 < 操作员使用。

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

此方法测试小于或等于 (对于 self 和 other)，并且由 <= 运算符使用。

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

此方法测试大于 (对于 self 和 other)，并且由 > 操作员使用。

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

此方法测试是否大于或等于 (对于 self 和 other)，并且由 >= 运算符使用。

impl ToSocketAddrs for SocketAddr

type Iter = IntoIter<SocketAddr>

在此类型可能对应的套接字地址上返回的迭代器。

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

将此对象转换为已解析的 SocketAddr 的迭代器。

impl Copy for SocketAddr

impl Eq for SocketAddr

impl StructuralEq for SocketAddr

impl StructuralPartialEq for SocketAddr