Struct core::net::SocketAddrV6

1.0.0 · source ·

pub struct SocketAddrV6 { /* private fields */ }

Expand description

IPv6 套接字地址。

IPv6 套接字地址由一个 IPv6 地址和一个 16 位端口号，以及包含流类别、流标签和作用域标识符的字段组成 (更多详细信息，请参见 IETF RFC 2553，第 3.3 节)。

有关同时包含 IPv4 和 IPv6 套接字地址的类型，请参见 SocketAddr。

SocketAddrV6 结构体的大小可能会因目标操作系统而异。不要假设此类型与底层系统表示具有相同的内存布局。

Examples

use std::net::{Ipv6Addr, SocketAddrV6};

let socket = SocketAddrV6::new(Ipv6Addr::new(0x2001, 0xdb8, 0, 0, 0, 0, 0, 1), 8080, 0, 0);

assert_eq!("[2001:db8::1]:8080".parse(), Ok(socket));
assert_eq!(socket.ip(), &Ipv6Addr::new(0x2001, 0xdb8, 0, 0, 0, 0, 0, 1));
assert_eq!(socket.port(), 8080);

Run

Implementations§

source §

impl SocketAddrV6

source

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

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

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

#![feature(addr_parse_ascii)]

use std::net::{Ipv6Addr, SocketAddrV6};

let socket = SocketAddrV6::new(Ipv6Addr::new(0x2001, 0xdb8, 0, 0, 0, 0, 0, 1), 8080, 0, 0);

assert_eq!(SocketAddrV6::parse_ascii(b"[2001:db8::1]:8080"), Ok(socket));

Run

source §

impl SocketAddrV6

const: 1.69.0 · source

pub const fn new( ip: Ipv6Addr, port: u16, flowinfo: u32, scope_id: u32 ) -> SocketAddrV6

从 IPv6 address，16 位端口号以及 flowinfo 和 scope_id 字段创建新的套接字地址。

有关 flowinfo 和 scope_id 参数的含义和布局的更多信息，请参见 IETF RFC 2553，第 3.3 节。

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 0);

Run

const: 1.69.0 · source

pub const fn ip(&self) -> &Ipv6Addr

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

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 0);
assert_eq!(socket.ip(), &Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1));

Run

1.9.0 · source

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

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

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let mut socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 0);
socket.set_ip(Ipv6Addr::new(76, 45, 0, 0, 0, 0, 0, 0));
assert_eq!(socket.ip(), &Ipv6Addr::new(76, 45, 0, 0, 0, 0, 0, 0));

Run

const: 1.69.0 · source

pub const fn port(&self) -> u16

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

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 0);
assert_eq!(socket.port(), 8080);

Run

1.9.0 · source

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

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

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let mut socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 0);
socket.set_port(4242);
assert_eq!(socket.port(), 4242);

Run

const: 1.69.0 · source

pub const fn flowinfo(&self) -> u32

返回与此地址关联的流信息。

该信息对应于 IETF RFC 2553，第 3.3 节中指定的 C 的 netinet/in.h 中的 sin6_flowinfo 字段。它结合了关于流标签和流量类别的信息，分别在 IETF RFC 2460，第 6 节和第 7 节中指定。

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 10, 0);
assert_eq!(socket.flowinfo(), 10);

Run

1.9.0 · source

pub fn set_flowinfo(&mut self, new_flowinfo: u32)

更改与此套接字地址关联的流信息。

有关更多详细信息，请参见 SocketAddrV6::flowinfo 的文档。

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let mut socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 10, 0);
socket.set_flowinfo(56);
assert_eq!(socket.flowinfo(), 56);

Run

const: 1.69.0 · source

pub const fn scope_id(&self) -> u32

返回与此地址关联的作用域 ID。

该信息对应于 IETF RFC 2553，第 3.3 节中指定的 C 的 netinet/in.h 中的 sin6_scope_id 字段。

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 78);
assert_eq!(socket.scope_id(), 78);

Run

1.9.0 · source

pub fn set_scope_id(&mut self, new_scope_id: u32)

更改与此套接字地址关联的作用域 ID。

有关更多详细信息，请参见 SocketAddrV6::scope_id 的文档。

Examples

use std::net::{SocketAddrV6, Ipv6Addr};

let mut socket = SocketAddrV6::new(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1), 8080, 0, 78);
socket.set_scope_id(42);
assert_eq!(socket.scope_id(), 42);