Struct Netv4Addr 

pub struct Netv4Addr { /* private fields */ }

A structure representing an IPv4 network.

Internally, this structure includes two values; an Ipv4Addr representing the network address (addr), and another representing the netmask (mask).

Implementations

impl Netv4Addr

pub const fn mask(&self) -> Ipv4Addr

pub const fn addr(&self) -> Ipv4Addr

pub fn is_cidr(&self) -> bool

pub fn new(addr: Ipv4Addr, mask: Ipv4Addr) -> Self

Create a new Netv4Addr from the given addr and mask.

Masks the given addr value with the given mask before the structure containing both is returned.

Examples

let network = Ipv4Addr::new(127, 0, 1, 1);
let netmask = Ipv4Addr::new(255, 0, 0, 0);
let netaddr = Netv4Addr::new(network, netmask);

// We do need to have the `Contains` trait in scope to use it...
use netaddr2::Contains;
let test: Ipv4Addr = Ipv4Addr::new(127, 47, 23, 37);
assert!(netaddr.contains(&test));

Trait Implementations

impl Broadcast for Netv4Addr

type Output = Ipv4Addr

The type of the broadcast address

fn broadcast(&self) -> Ipv4Addr

Compute the broadcast address

impl Clone for Netv4Addr

fn clone(&self) -> Netv4Addr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Contains<IpAddr> for Netv4Addr

fn contains(&self, other: &IpAddr) -> bool

impl Contains<Ipv4Addr> for Netv4Addr

fn contains(&self, other: &Ipv4Addr) -> bool

impl Contains<NetAddr> for Netv4Addr

fn contains(&self, other: &NetAddr) -> bool

impl Contains<Netv4Addr> for NetAddr

fn contains(&self, other: &Netv4Addr) -> bool

impl Contains<Netv4Addr> for Netv4Addr

fn contains(&self, other: &Netv4Addr) -> bool

impl Debug for Netv4Addr

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Netv4Addr

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Netv4Addr

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

Formats the value using the given formatter.

impl From<Ipv4Addr> for Netv4Addr

fn from(addr: Ipv4Addr) -> Self

Converts to this type from the input type.

impl From<Netv4Addr> for NetAddr

fn from(netaddr: Netv4Addr) -> Self

Converts to this type from the input type.

impl FromStr for Netv4Addr

fn from_str(string: &str) -> Result<Self>

Parse a Netv4Addr from a string

Often used implicitly, this implementation allows for a few formats to be given:

• (Standard) CIDR format: 192.0.2.16/29
• Extended format ( -delimited): 192.0.2.16 255.255.255.248
• Extended format (/-delimited): 192.0.2.16/255.255.255.248

Examples

let parsed: Netv4Addr = "192.0.2.16/29".parse().unwrap();
let addr: std::net::Ipv4Addr = "192.0.2.16".parse().unwrap();
let mask: std::net::Ipv4Addr = "255.255.255.248".parse().unwrap();
assert_eq!(parsed, Netv4Addr::new(addr, mask));

let parsed: Netv4Addr = "192.0.2.16 255.255.255.248".parse().unwrap();
let addr: std::net::Ipv4Addr = "192.0.2.16".parse().unwrap();
let mask: std::net::Ipv4Addr = "255.255.255.248".parse().unwrap();
assert_eq!(parsed, Netv4Addr::new(addr, mask));

let parsed: Netv4Addr = "192.0.2.16/255.255.255.248".parse().unwrap();
let addr: std::net::Ipv4Addr = "192.0.2.16".parse().unwrap();
let mask: std::net::Ipv4Addr = "255.255.255.248".parse().unwrap();
assert_eq!(parsed, Netv4Addr::new(addr, mask));

type Err = Error

The associated error which can be returned from parsing.

impl Hash for Netv4Addr

fn hash<__H: Hasher>(&self, state: &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 Merge for Netv4Addr

type Output = Option<Netv4Addr>

The type of the result of the merge

fn merge(&self, other: &Self) -> Self::Output

Perform the merging operation

impl Ord for Netv4Addr

fn cmp(&self, other: &Self) -> 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 Netv4Addr

fn eq(&self, other: &Netv4Addr) -> 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 Netv4Addr

fn partial_cmp(&self, other: &Self) -> 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 Serialize for Netv4Addr

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Copy for Netv4Addr

impl Eq for Netv4Addr

impl StructuralPartialEq for Netv4Addr