Enum core::net::SocketAddr

1.0.0 · source ·

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

Expand description

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);

Run

Variants§

§

V4(SocketAddrV4)

IPv4 套接字地址。

§

V6(SocketAddrV6)

IPv6 套接字地址。

Implementations§

source §

impl SocketAddr

source

pub fn parse_ascii(b: &[u8]) -> Result<Self, AddrParseError>

🔬This is a nightly-only experimental API. (addr_parse_ascii #101035)

从字节片中解析套接字地址。

#![feature(addr_parse_ascii)]

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

let socket_v4 = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(127, 0, 0, 1)), 8080);
let socket_v6 = SocketAddr::new(IpAddr::V6(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1)), 8080);

assert_eq!(SocketAddr::parse_ascii(b"127.0.0.1:8080"), Ok(socket_v4));
assert_eq!(SocketAddr::parse_ascii(b"[::1]:8080"), Ok(socket_v6));

Run

source §

impl SocketAddr

1.7.0 (const: 1.69.0) · source

pub const 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);

Run

1.7.0 (const: 1.69.0) · source

pub const 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)));

Run

1.9.0 · source

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)));

Run

const: 1.69.0 · source

pub const 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);

Run

1.9.0 · source

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);

Run

1.16.0 (const: 1.69.0) · source

pub const 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);

Run

1.16.0 (const: 1.69.0) · source

pub const 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);