Struct ipnet::Emu128

pub struct Emu128 {
    pub hi: u64,
    pub lo: u64,
}

An emulated 128 bit unsigned integer.

This module provides Emu128, a 128 bit unsigned integer that is emulated using two u64 types. This is useful for operations on IPv6 address, which are 128 bit unsigned integers.

Currently Emu128 only implements those operations that are useful for the Ipv6Net type. It is not intended to become a full u128 implementation.

Conversion between Ipv6Addr and Emu128 is provided by a From and Into implementation on Emu128. The into() method must be used to convert from an Ipv6Addr to an Emu128 because it is not possible to implement From<Emu128> for Ipv6Addr.

Examples

use std::net::Ipv6Addr;
use ipnet::Emu128;

let i1 = Emu128::from(1); // convert from u32
let i2 = Emu128::from([1, 1]); // convert from [u64; 2]
let slice: [u64; 2] = i2.into(); // convert into [u64; 2]

let a1: Ipv6Addr = "fd00::1".parse().unwrap();
let u1 = Emu128 { hi: 0xfd00_0000_0000_0000, lo: 1 };
let a2: Ipv6Addr = u1.into();
let u2: Emu128 = a1.into();

assert_eq!(a1, a2);
assert_eq!(u1, u2);
assert_eq!(u1, Emu128::from(a1));

Fields

hi: u64

lo: u64

Methods

impl Emu128

pub fn min_value() -> Emu128

pub fn max_value() -> Emu128

pub fn saturating_add(self, other: Emu128) -> Emu128

pub fn saturating_sub(self, other: Emu128) -> Emu128

pub fn checked_shl(self, rhs: u8) -> Option<Self>

pub fn checked_shr(self, rhs: u8) -> Option<Self>

pub fn leading_zeros(self) -> u32

pub fn trailing_zeros(self) -> u32

Trait Implementations

impl Copy for Emu128

impl Clone for Emu128

fn clone(&self) -> Emu128

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Eq for Emu128

impl PartialEq for Emu128

fn eq(&self, __arg_0: &Emu128) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &Emu128) -> bool

This method tests for !=.

impl Ord for Emu128

fn cmp(&self, __arg_0: &Emu128) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

impl PartialOrd for Emu128

fn partial_cmp(&self, __arg_0: &Emu128) -> Option<Ordering>

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

fn lt(&self, __arg_0: &Emu128) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, __arg_0: &Emu128) -> bool

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

fn gt(&self, __arg_0: &Emu128) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, __arg_0: &Emu128) -> bool

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

impl Hash for Emu128

fn hash<__H: Hasher>(&self, __arg_0: &mut __H)

Feeds this value into the given [Hasher].

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

Feeds a slice of this type into the given [Hasher].

impl Debug for Emu128

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for Emu128

fn default() -> Emu128

Returns the "default value" for a type.

impl Shl<u8> for Emu128

type Output = Self

The resulting type after applying the << operator.

fn shl(self, rhs: u8) -> Emu128

Performs the << operation.

impl Shr<u8> for Emu128

type Output = Self

The resulting type after applying the >> operator.

fn shr(self, rhs: u8) -> Emu128

Performs the >> operation.

impl BitAnd for Emu128

type Output = Self

The resulting type after applying the & operator.

fn bitand(self, rhs: Emu128) -> Emu128

Performs the & operation.

impl BitOr for Emu128

type Output = Self

The resulting type after applying the | operator.

fn bitor(self, rhs: Emu128) -> Emu128

Performs the | operation.

impl From<u32> for Emu128

fn from(u: u32) -> Self

Performs the conversion.

impl From<[u64; 2]> for Emu128

fn from(slice: [u64; 2]) -> Self

Performs the conversion.

impl From<Emu128> for [u64; 2]

fn from(u: Emu128) -> Self

Performs the conversion.

impl From<Ipv6Addr> for Emu128

fn from(ip: Ipv6Addr) -> Self

Performs the conversion.

impl Into<Ipv6Addr> for Emu128

fn into(self) -> Ipv6Addr

Performs the conversion.

impl Display for Emu128

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

Formats the value using the given formatter.

impl IpAdd<Emu128> for Ipv6Addr

type Output = Ipv6Addr

fn saturating_add(self, rhs: Emu128) -> Ipv6Addr

impl IpSub<Emu128> for Ipv6Addr

type Output = Ipv6Addr

fn saturating_sub(self, rhs: Emu128) -> Ipv6Addr

impl IpBitAnd<Emu128> for Ipv6Addr

type Output = Ipv6Addr

fn bitand(self, rhs: Emu128) -> Ipv6Addr

impl IpBitOr<Emu128> for Ipv6Addr

type Output = Ipv6Addr

fn bitor(self, rhs: Emu128) -> Ipv6Addr