Struct IpV6Address

#[repr(C)]
pub struct IpV6Address { /* private fields */ }

Implementations

impl IpV6Address

pub fn new<octets: Into<[u8; 16]>>(octets: octets) -> Self

pub fn as_bytes(&self) -> &[u8]

pub fn as_bytes_mut(&mut self) -> &mut [u8]

impl IpV6Address

pub const UNSPECIFIED: Self

An unspecified IpV6Address

pub const fn segments(&self) -> [u16; 8]

pub const fn unmap(self) -> IpAddress

Converts the IP address into IPv4 if it is mapped, otherwise the address is unchanged

pub const fn unicast_scope(self) -> Option<UnicastScope>

Returns the ip::UnicastScope for the given address

See the IANA Registry for more details.

use s2n_quic_core::inet::{IpV4Address, IpV6Address, ip::UnicastScope::*};

assert_eq!(IpV6Address::from([0, 0, 0, 0, 0, 0, 0, 0]).unicast_scope(), None);
assert_eq!(IpV6Address::from([0, 0, 0, 0, 0, 0, 0, 1]).unicast_scope(), Some(Loopback));
assert_eq!(IpV6Address::from([0xff0e, 0, 0, 0, 0, 0, 0, 0]).unicast_scope(), None);
assert_eq!(IpV6Address::from([0xfe80, 0, 0, 0, 0, 0, 0, 0]).unicast_scope(), Some(LinkLocal));
assert_eq!(IpV6Address::from([0xfc02, 0, 0, 0, 0, 0, 0, 0]).unicast_scope(), Some(Private));
// documentation
assert_eq!(IpV6Address::from([0x2001, 0xdb8, 0, 0, 0, 0, 0, 0]).unicast_scope(), None);
// benchmarking
assert_eq!(IpV6Address::from([0x2001, 0x0200, 0, 0, 0, 0, 0, 0]).unicast_scope(), None);
// IPv4-mapped address
assert_eq!(IpV4Address::from([92, 88, 99, 123]).to_ipv6_mapped().unicast_scope(), Some(Global));

pub fn with_port(self, port: u16) -> SocketAddressV6

Trait Implementations

impl Clone for IpV6Address

fn clone(&self) -> IpV6Address

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IpV6Address

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

Formats the value using the given formatter.

impl<'a> DecoderValue<'a> for &'a IpV6Address

where IpV6Address: FromBytes,

fn decode(buffer: DecoderBuffer<'a>) -> DecoderBufferResult<'a, Self>

impl<'a> DecoderValue<'a> for IpV6Address

where IpV6Address: FromBytes,

fn decode(buffer: DecoderBuffer<'a>) -> DecoderBufferResult<'a, Self>

impl<'a> DecoderValueMut<'a> for &'a IpV6Address

where IpV6Address: FromBytes,

fn decode_mut(buffer: DecoderBufferMut<'a>) -> DecoderBufferMutResult<'a, Self>

impl<'a> DecoderValueMut<'a> for &'a mut IpV6Address

where IpV6Address: FromBytes,

fn decode_mut(buffer: DecoderBufferMut<'a>) -> DecoderBufferMutResult<'a, Self>

impl<'a> DecoderValueMut<'a> for IpV6Address

where IpV6Address: FromBytes,

fn decode_mut(buffer: DecoderBufferMut<'a>) -> DecoderBufferMutResult<'a, Self>

impl Default for IpV6Address

fn default() -> IpV6Address

Returns the “default value” for a type.

impl Display for IpV6Address

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

Formats the value using the given formatter.

impl<'a> EncoderValue for &'a IpV6Address

where IpV6Address: IntoBytes,

fn encoding_size(&self) -> usize

Returns the encoding size with no buffer constrains

fn encoding_size_for_encoder<E: Encoder>(&self, _encoder: &E) -> usize

Returns the encoding size for the given encoder’s capacity

fn encode<E: Encoder>(&self, encoder: &mut E)

Encodes the value into the encoder

fn encode_mut<E>(&mut self, encoder: &mut E)

where E: Encoder,

Encodes the value into the encoder, while potentially mutating the value itself

fn encode_with_len_prefix<Len, E>(&self, encoder: &mut E)

where Len: TryFrom<usize> + EncoderValue, E: Encoder, Self: Sized, <Len as TryFrom<usize>>::Error: Debug,

Encodes the value into the encoder with a prefix of Len

fn encode_to_vec(&self) -> Vec<u8>

impl<'a> EncoderValue for &'a mut IpV6Address

where IpV6Address: IntoBytes,

fn encoding_size(&self) -> usize

Returns the encoding size with no buffer constrains

fn encoding_size_for_encoder<E: Encoder>(&self, _encoder: &E) -> usize

Returns the encoding size for the given encoder’s capacity

fn encode<E: Encoder>(&self, encoder: &mut E)

Encodes the value into the encoder

fn encode_mut<E>(&mut self, encoder: &mut E)

where E: Encoder,

Encodes the value into the encoder, while potentially mutating the value itself

fn encode_with_len_prefix<Len, E>(&self, encoder: &mut E)

where Len: TryFrom<usize> + EncoderValue, E: Encoder, Self: Sized, <Len as TryFrom<usize>>::Error: Debug,

Encodes the value into the encoder with a prefix of Len

fn encode_to_vec(&self) -> Vec<u8>

impl EncoderValue for IpV6Address

where IpV6Address: IntoBytes,

fn encoding_size(&self) -> usize

Returns the encoding size with no buffer constrains

fn encoding_size_for_encoder<E: Encoder>(&self, _encoder: &E) -> usize

Returns the encoding size for the given encoder’s capacity

fn encode<E: Encoder>(&self, encoder: &mut E)

Encodes the value into the encoder

fn encode_mut<E>(&mut self, encoder: &mut E)

where E: Encoder,

Encodes the value into the encoder, while potentially mutating the value itself

fn encode_with_len_prefix<Len, E>(&self, encoder: &mut E)

where Len: TryFrom<usize> + EncoderValue, E: Encoder, Self: Sized, <Len as TryFrom<usize>>::Error: Debug,

Encodes the value into the encoder with a prefix of Len

fn encode_to_vec(&self) -> Vec<u8>

impl<'a> From<&'a IpV6Address> for IpAddressRef<'a>

fn from(ip: &'a IpV6Address) -> Self

Converts to this type from the input type.

impl From<&Ipv6Addr> for IpV6Address

fn from(address: &Ipv6Addr) -> Self

Converts to this type from the input type.

impl From<[u16; 8]> for IpV6Address

fn from(octets: [u16; 8]) -> Self

Converts to this type from the input type.

impl From<[u8; 16]> for IpV6Address

fn from(octets: [u8; 16]) -> Self

Converts to this type from the input type.

impl From<IpV6Address> for [u16; 8]

fn from(v: IpV6Address) -> Self

Converts to this type from the input type.

impl From<IpV6Address> for [u8; 16]

fn from(v: IpV6Address) -> Self

Converts to this type from the input type.

impl From<IpV6Address> for IpAddress

fn from(ip: IpV6Address) -> Self

Converts to this type from the input type.

impl From<IpV6Address> for Ipv6Addr

fn from(address: IpV6Address) -> Self

Converts to this type from the input type.

impl From<Ipv6Addr> for IpV6Address

fn from(address: Ipv6Addr) -> Self

Converts to this type from the input type.

impl FromBytes for IpV6Address

where [u8; 16]: FromBytes,

fn read_from_bytes(source: &[u8]) -> Result<Self, SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the given source.

fn read_from_prefix( source: &[u8], ) -> Result<(Self, &[u8]), SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the prefix of the given source.

fn read_from_suffix( source: &[u8], ) -> Result<(&[u8], Self), SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the suffix of the given source.

impl FromZeros for IpV6Address

where [u8; 16]: FromZeros,

fn zero(&mut self)

Overwrites self with zeros.

fn new_zeroed() -> Self

where Self: Sized,

Creates an instance of Self from zeroed bytes.

impl Hash for IpV6Address

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl IntoBytes for IpV6Address

where [u8; 16]: IntoBytes,

fn as_bytes(&self) -> &[u8]

where Self: Immutable,

Gets the bytes of this value.

fn as_mut_bytes(&mut self) -> &mut [u8]

where Self: FromBytes,

Gets the bytes of this value mutably.

fn write_to(&self, dst: &mut [u8]) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to dst.

fn write_to_prefix( &self, dst: &mut [u8], ) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to the prefix of dst.

fn write_to_suffix( &self, dst: &mut [u8], ) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to the suffix of dst.

impl Ord for IpV6Address

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for IpV6Address

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for IpV6Address

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

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl TryFromBytes for IpV6Address

where [u8; 16]: TryFromBytes,

fn try_read_from_bytes( source: &[u8], ) -> Result<Self, ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read the given source as a Self.

fn try_read_from_prefix( source: &[u8], ) -> Result<(Self, &[u8]), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read a Self from the prefix of the given source.

fn try_read_from_suffix( source: &[u8], ) -> Result<(&[u8], Self), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read a Self from the suffix of the given source.

impl Unspecified for IpV6Address

fn is_unspecified(&self) -> bool

Returns true if the value is unspecified

fn filter_unspecified(self) -> Option<Self>

Coerce a potentially unspecified value into an Option<Self>

impl Copy for IpV6Address

impl Eq for IpV6Address

impl Immutable for IpV6Address

where [u8; 16]: Immutable,

impl StructuralPartialEq for IpV6Address

impl Unaligned for IpV6Address

where [u8; 16]: Unaligned,