pub struct SocketAddrV6 { /* private fields */ }
Expand description
An IPv6 socket address.
IPv6 socket addresses consist of an IPv6
address, a 16-bit port number, as well
as fields containing the traffic class, the flow label, and a scope identifier
(see IETF RFC 2553, Section 3.3 for more details).
See SocketAddr
for a type encompassing both IPv4 and IPv6 socket addresses.
The size of a SocketAddrV6
struct may vary depending on the target operating
system. Do not assume that this type has the same memory layout as the underlying
system representation.
§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§
source§impl SocketAddrV6
impl SocketAddrV6
sourcepub fn parse_ascii(b: &[u8]) -> Result<SocketAddrV6, AddrParseError>
🔬This is a nightly-only experimental API. (addr_parse_ascii
)
pub fn parse_ascii(b: &[u8]) -> Result<SocketAddrV6, AddrParseError>
addr_parse_ascii
)Parse an IPv6 socket address from a slice of bytes.
#![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));
source§impl SocketAddrV6
impl SocketAddrV6
1.0.0 (const: 1.69.0) · sourcepub const fn new(
ip: Ipv6Addr,
port: u16,
flowinfo: u32,
scope_id: u32,
) -> SocketAddrV6
pub const fn new( ip: Ipv6Addr, port: u16, flowinfo: u32, scope_id: u32, ) -> SocketAddrV6
Creates a new socket address from an IPv6
address, a 16-bit port number,
and the flowinfo
and scope_id
fields.
For more information on the meaning and layout of the flowinfo
and scope_id
parameters, see 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);
1.0.0 (const: 1.69.0) · sourcepub const fn ip(&self) -> &Ipv6Addr
pub const fn ip(&self) -> &Ipv6Addr
Returns the IP address associated with this socket address.
§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));
1.9.0 · sourcepub fn set_ip(&mut self, new_ip: Ipv6Addr)
pub fn set_ip(&mut self, new_ip: Ipv6Addr)
Changes the IP address associated with this socket address.
§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));
1.0.0 (const: 1.69.0) · sourcepub const fn port(&self) -> u16
pub const fn port(&self) -> u16
Returns the port number associated with this socket address.
§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);
1.9.0 · sourcepub fn set_port(&mut self, new_port: u16)
pub fn set_port(&mut self, new_port: u16)
Changes the port number associated with this socket address.
§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);
1.0.0 (const: 1.69.0) · sourcepub const fn flowinfo(&self) -> u32
pub const fn flowinfo(&self) -> u32
Returns the flow information associated with this address.
This information corresponds to the sin6_flowinfo
field in C’s netinet/in.h
,
as specified in IETF RFC 2553, Section 3.3.
It combines information about the flow label and the traffic class as specified
in IETF RFC 2460, respectively Section 6 and 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);
1.9.0 · sourcepub fn set_flowinfo(&mut self, new_flowinfo: u32)
pub fn set_flowinfo(&mut self, new_flowinfo: u32)
Changes the flow information associated with this socket address.
See SocketAddrV6::flowinfo
’s documentation for more details.
§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);
1.0.0 (const: 1.69.0) · sourcepub const fn scope_id(&self) -> u32
pub const fn scope_id(&self) -> u32
Returns the scope ID associated with this address.
This information corresponds to the sin6_scope_id
field in C’s netinet/in.h
,
as specified in 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, 78);
assert_eq!(socket.scope_id(), 78);
1.9.0 · sourcepub fn set_scope_id(&mut self, new_scope_id: u32)
pub fn set_scope_id(&mut self, new_scope_id: u32)
Changes the scope ID associated with this socket address.
See SocketAddrV6::scope_id
’s documentation for more details.
§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§
1.0.0 · source§impl Clone for SocketAddrV6
impl Clone for SocketAddrV6
source§fn clone(&self) -> SocketAddrV6
fn clone(&self) -> SocketAddrV6
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more1.0.0 · source§impl Debug for SocketAddrV6
impl Debug for SocketAddrV6
source§impl<'de> Deserialize<'de> for SocketAddrV6
impl<'de> Deserialize<'de> for SocketAddrV6
source§fn deserialize<D>(
deserializer: D,
) -> Result<SocketAddrV6, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
fn deserialize<D>(
deserializer: D,
) -> Result<SocketAddrV6, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
1.0.0 · source§impl Display for SocketAddrV6
impl Display for SocketAddrV6
1.16.0 · source§impl From<SocketAddrV6> for SocketAddr
impl From<SocketAddrV6> for SocketAddr
source§fn from(sock6: SocketAddrV6) -> SocketAddr
fn from(sock6: SocketAddrV6) -> SocketAddr
Converts a SocketAddrV6
into a SocketAddr::V6
.
source§impl From<SocketAddrV6> for SocketAddrAny
impl From<SocketAddrV6> for SocketAddrAny
source§fn from(from: SocketAddrV6) -> Self
fn from(from: SocketAddrV6) -> Self
1.5.0 · source§impl FromStr for SocketAddrV6
impl FromStr for SocketAddrV6
source§type Err = AddrParseError
type Err = AddrParseError
source§fn from_str(s: &str) -> Result<SocketAddrV6, AddrParseError>
fn from_str(s: &str) -> Result<SocketAddrV6, AddrParseError>
s
to return a value of this type. Read more1.0.0 · source§impl Hash for SocketAddrV6
impl Hash for SocketAddrV6
1.0.0 · source§impl Ord for SocketAddrV6
impl Ord for SocketAddrV6
source§fn cmp(&self, other: &SocketAddrV6) -> Ordering
fn cmp(&self, other: &SocketAddrV6) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
1.0.0 · source§impl PartialEq for SocketAddrV6
impl PartialEq for SocketAddrV6
1.0.0 · source§impl PartialOrd for SocketAddrV6
impl PartialOrd for SocketAddrV6
source§impl Serialize for SocketAddrV6
impl Serialize for SocketAddrV6
source§fn serialize<S>(
&self,
serializer: S,
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
fn serialize<S>(
&self,
serializer: S,
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
1.0.0 · source§impl ToSocketAddrs for SocketAddrV6
impl ToSocketAddrs for SocketAddrV6
source§type Iter = IntoIter<SocketAddr>
type Iter = IntoIter<SocketAddr>
source§fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>, Error>
fn to_socket_addrs(&self) -> Result<IntoIter<SocketAddr>, Error>
SocketAddr
s. Read moreimpl Copy for SocketAddrV6
impl Eq for SocketAddrV6
impl StructuralPartialEq for SocketAddrV6
Auto Trait Implementations§
impl Freeze for SocketAddrV6
impl RefUnwindSafe for SocketAddrV6
impl Send for SocketAddrV6
impl Sync for SocketAddrV6
impl Unpin for SocketAddrV6
impl UnwindSafe for SocketAddrV6
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)