Enum ipnetwork::IpNetwork
[−]
[src]
pub enum IpNetwork { V4(Ipv4Network), V6(Ipv6Network), }
Represents a generic network range. This type can have two variants: the v4 and the v6 case.
Variants
V4(Ipv4Network)
V6(Ipv6Network)
Methods
impl IpNetwork
[src]
pub fn new(ip: IpAddr, prefix: u8) -> Result<IpNetwork, IpNetworkError>
[src]
Constructs a new IpNetwork
from a given IpAddr
and a prefix denoting the
network size. If the prefix is larger than 32 (for IPv4) or 128 (for IPv6), this
will raise an IpNetworkError::InvalidPrefix
error. Support for IPv6 is not
complete yet.
pub fn ip(&self) -> IpAddr
[src]
Returns the IP part of a given IpNetwork
pub fn prefix(&self) -> u8
[src]
Returns the prefix of the given IpNetwork
Example
use ipnetwork::IpNetwork; assert_eq!(IpNetwork::V4("10.9.0.32/16".parse().unwrap()).prefix(), 16u8); assert_eq!(IpNetwork::V6("ff01::0/32".parse().unwrap()).prefix(), 32u8);
pub fn mask(&self) -> IpAddr
[src]
Returns the mask for this IpNetwork
.
That means the prefix
most significant bits will be 1 and the rest 0
Example
use ipnetwork::IpNetwork; use std::net::{Ipv4Addr, Ipv6Addr}; let v4_net: IpNetwork = "10.9.0.32/16".parse().unwrap(); assert_eq!(v4_net.mask(), Ipv4Addr::new(255, 255, 0, 0)); let v6_net: IpNetwork = "ff01::0/32".parse().unwrap(); assert_eq!(v6_net.mask(), Ipv6Addr::new(0xffff, 0xffff, 0, 0, 0, 0, 0, 0));
pub fn is_ipv4(&self) -> bool
[src]
Returns true if the IP in this IpNetwork
is a valid IPv4 address,
false if it's a valid IPv6 address.
Example
use ipnetwork::IpNetwork; let v4: IpNetwork = IpNetwork::V4("10.9.0.32/16".parse().unwrap()); assert_eq!(v4.is_ipv4(), true); assert_eq!(v4.is_ipv6(), false);
pub fn is_ipv6(&self) -> bool
[src]
Returns true if the IP in this IpNetwork
is a valid IPv6 address,
false if it's a valid IPv4 address.
Example
use ipnetwork::IpNetwork; let v6: IpNetwork = IpNetwork::V6("ff01::0/32".parse().unwrap()); assert_eq!(v6.is_ipv6(), true); assert_eq!(v6.is_ipv4(), false);
pub fn contains(&self, ip: IpAddr) -> bool
[src]
Checks if a given IpAddr
is in this IpNetwork
Examples
use std::net::IpAddr; use ipnetwork::IpNetwork; let net: IpNetwork = "127.0.0.0/24".parse().unwrap(); let ip1: IpAddr = "127.0.0.1".parse().unwrap(); let ip2: IpAddr = "172.0.0.1".parse().unwrap(); let ip4: IpAddr = "::1".parse().unwrap(); assert!(net.contains(ip1)); assert!(!net.contains(ip2)); assert!(!net.contains(ip4));
Trait Implementations
impl Debug for IpNetwork
[src]
fn fmt(&self, __arg_0: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl Clone for IpNetwork
[src]
fn clone(&self) -> IpNetwork
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Copy for IpNetwork
[src]
impl Hash for IpNetwork
[src]
fn hash<__H: Hasher>(&self, __arg_0: &mut __H)
[src]
Feeds this value into the given [Hasher
]. Read more
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
Feeds a slice of this type into the given [Hasher
]. Read more
impl PartialEq for IpNetwork
[src]
fn eq(&self, __arg_0: &IpNetwork) -> bool
[src]
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &IpNetwork) -> bool
[src]
This method tests for !=
.
impl Eq for IpNetwork
[src]
impl PartialOrd for IpNetwork
[src]
fn partial_cmp(&self, __arg_0: &IpNetwork) -> Option<Ordering>
[src]
This method returns an ordering between self
and other
values if one exists. Read more
fn lt(&self, __arg_0: &IpNetwork) -> bool
[src]
This method tests less than (for self
and other
) and is used by the <
operator. Read more
fn le(&self, __arg_0: &IpNetwork) -> bool
[src]
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
fn gt(&self, __arg_0: &IpNetwork) -> bool
[src]
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
fn ge(&self, __arg_0: &IpNetwork) -> bool
[src]
This method tests greater than or equal to (for self
and other
) and is used by the >=
operator. Read more
impl Ord for IpNetwork
[src]
fn cmp(&self, __arg_0: &IpNetwork) -> Ordering
[src]
This method returns an Ordering
between self
and other
. Read more
fn max(self, other: Self) -> Self
1.21.0[src]
Compares and returns the maximum of two values. Read more
fn min(self, other: Self) -> Self
1.21.0[src]
Compares and returns the minimum of two values. Read more
impl FromStr for IpNetwork
[src]
Tries to parse the given string into a IpNetwork
. Will first try to parse
it as an Ipv4Network
and if that fails as an Ipv6Network
. If both
fails it will return an InvalidAddr
error.
Examples
use std::net::Ipv4Addr; use ipnetwork::{IpNetwork, Ipv4Network}; let expected = IpNetwork::V4(Ipv4Network::new(Ipv4Addr::new(10, 1, 9, 32), 16).unwrap()); let from_cidr: IpNetwork = "10.1.9.32/16".parse().unwrap(); assert_eq!(expected, from_cidr);
type Err = IpNetworkError
The associated error which can be returned from parsing.
fn from_str(s: &str) -> Result<IpNetwork, IpNetworkError>
[src]
Parses a string s
to return a value of this type. Read more
impl From<Ipv4Network> for IpNetwork
[src]
fn from(v4: Ipv4Network) -> IpNetwork
[src]
Performs the conversion.
impl From<Ipv6Network> for IpNetwork
[src]
fn from(v6: Ipv6Network) -> IpNetwork
[src]
Performs the conversion.