Struct std::net::SocketAddrV6

pub struct SocketAddrV6 { /* fields omitted */ }

IPv6 套接字地址。

IPv6 套接字地址由 IPv6 address，16 位端口号以及包含流量类别，流标签和作用域标识符的字段组成 (有关更多详细信息，请参见 IETF RFC 2553, Section 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);

Implementations

impl SocketAddrV6

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

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

有关 flowinfo 和 scope_id 参数的含义和布局的更多信息，请参见 IETF RFC 2553, Section 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);

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

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

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

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

pub fn flowinfo(&self) -> u32

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

该信息对应于 IETF RFC 2553, Section 3.3 中指定的 C 的 netinet/in.h 中的 sin6_flowinfo 字段。 它结合了关于流标签和流量类别的信息，分别在 IETF RFC 2460，Section 6 和 Section 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);

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

pub fn scope_id(&self) -> u32

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

该信息对应于 IETF RFC 2553, Section 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);

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

Trait Implementations

impl Clone for SocketAddrV6

fn clone(&self) -> SocketAddrV6

返回值的副本。

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

从 source 执行复制分配。

impl Debug for SocketAddrV6

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

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

impl Display for SocketAddrV6

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

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

impl From<SocketAddrV6> for SocketAddr

fn from(sock6: SocketAddrV6) -> SocketAddr

将 SocketAddrV6 转换为 SocketAddr::V6。

impl FromStr for SocketAddrV6

type Err = AddrParseError

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

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

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

impl Hash for SocketAddrV6

fn hash<H: Hasher>(&self, s: &mut H)

将该值输入给定的 Hasher。

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

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

impl Ord for SocketAddrV6

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

将值限制为一定的时间间隔。

impl PartialEq<SocketAddrV6> for SocketAddrV6

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

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

#[must_use]

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

此方法测试 !=。

impl PartialOrd<SocketAddrV6> for SocketAddrV6

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

impl ToSocketAddrs for SocketAddrV6

type Iter = IntoIter<SocketAddr>

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

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

将此 object 转换为解析的 SocketAddr 的迭代器。

impl Copy for SocketAddrV6

impl Eq for SocketAddrV6