Struct Cidr 

pub struct Cidr { /* private fields */ }

A network block: a normalized network address and a prefix length.

Examples

use net_io::Cidr;
let office: Cidr = "203.0.113.0/24".parse()?;
assert!(office.contains("203.0.113.9".parse().unwrap()));
assert!(!office.contains("198.51.100.1".parse().unwrap()));
assert_eq!(office.to_string(), "203.0.113.0/24");
assert!(Cidr::parse("10.0.0.1/8").is_err());
assert_eq!(Cidr::new_masked("10.0.0.1".parse().unwrap(), 8)?.to_string(), "10.0.0.0/8");

Implementations

impl Cidr

pub fn new(ip: IpAddr, prefix: u8) -> Result<Cidr, AddrError>

A block whose host bits must be zero.

Errors

AddrError::PrefixTooLong, AddrError::HostBitsSet.

let block = net_io::Cidr::new("10.0.0.0".parse().unwrap(), 8)?;
assert_eq!(block.prefix_len(), 8);

pub fn new_masked(ip: IpAddr, prefix: u8) -> Result<Cidr, AddrError>

A block that clears host bits instead of refusing them.

Errors

AddrError::PrefixTooLong.

let block = net_io::Cidr::new_masked("192.0.2.77".parse().unwrap(), 24)?;
assert_eq!(block.to_string(), "192.0.2.0/24");

pub fn parse(text: &str) -> Result<Cidr, AddrError>

Parses "10.0.0.0/8", "2001:db8::/32", or a bare address (/32 or /128).

Canonical text only: no leading zeros in IPv4 octets, no zone ids, no whitespace.

Errors

AddrError::Empty, AddrError::Syntax, AddrError::PrefixTooLong, AddrError::HostBitsSet.

let block = net_io::Cidr::parse("::1")?;
assert_eq!(block.prefix_len(), 128);

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

Whether the block contains ip (normalized first).

let block = net_io::Cidr::parse("10.0.0.0/8")?;
assert!(block.contains("::ffff:10.1.2.3".parse().unwrap()));

pub fn network(&self) -> IpAddr

The network address.

let block = net_io::Cidr::parse("10.0.0.0/8")?;
assert_eq!(block.network().to_string(), "10.0.0.0");

pub fn prefix_len(&self) -> u8

The prefix length.

assert_eq!(net_io::Cidr::parse("10.0.0.0/8")?.prefix_len(), 8);

pub fn is_ipv4(&self) -> bool

Whether this is an IPv4 block.

assert!(net_io::Cidr::parse("10.0.0.0/8")?.is_ipv4());

Trait Implementations

impl Clone for Cidr

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Cidr

impl Debug for Cidr

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

Formats the value using the given formatter.

impl Display for Cidr

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

Formats the value using the given formatter.

impl Eq for Cidr

impl FromStr for Cidr

type Err = AddrError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Cidr, AddrError>

Parses a string s to return a value of this type.

impl Hash for Cidr

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 PartialEq for Cidr

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Cidr