Enum ip_network::IpNetwork

source · [−]

pub enum IpNetwork {
    V4(Ipv4Network),
    V6(Ipv6Network),
}

Expand description

Holds IPv4 or IPv6 network.

Variants

`V4(Ipv4Network)`

`V6(Ipv6Network)`

Implementations

source

impl IpNetwork

source

pub fn new<I: Into<IpAddr>>(
network_address: I,
netmask: u8
) -> Result<Self, IpNetworkError>

Constructs new IpNetwork based on IpAddr and netmask.

Examples

use std::net::{IpAddr, Ipv4Addr};
use std::str::FromStr;
use ip_network::{IpNetwork, Ipv4Network};

let network_address = IpAddr::V4(Ipv4Addr::new(192, 168, 1, 0));
let ip_network = IpNetwork::new(network_address, 24)?;
assert_eq!(ip_network.network_address(), IpAddr::V4(Ipv4Addr::new(192, 168, 1, 0)));
assert_eq!(ip_network.netmask(), 24);

source

pub fn new_truncate<I: Into<IpAddr>>(
network_address: I,
netmask: u8
) -> Result<Self, IpNetworkError>

Constructs new IpNetwork based on IpAddr and netmask with truncating host bits from given network_address.

Returns error if netmask is bigger than 32 for IPv4 and 128 for IPv6.

Examples

use std::net::{IpAddr, Ipv4Addr};
use ip_network::IpNetwork;

let network_address = IpAddr::V4(Ipv4Addr::new(192, 168, 1, 128));
let ip_network = IpNetwork::new_truncate(network_address, 24)?;
assert_eq!(ip_network.network_address(), IpAddr::V4(Ipv4Addr::new(192, 168, 1, 0)));
assert_eq!(ip_network.netmask(), 24);

source

pub fn network_address(&self) -> IpAddr

Returns network IP address.

Examples

use std::net::{IpAddr, Ipv4Addr};
use ip_network::IpNetwork;

let ip_network = IpNetwork::new(Ipv4Addr::new(192, 168, 1, 0), 24)?;
assert_eq!(ip_network.network_address(), IpAddr::V4(Ipv4Addr::new(192, 168, 1, 0)));

source

pub fn netmask(&self) -> u8

Returns network mask as integer.

Examples

use std::net::{IpAddr, Ipv4Addr};
use ip_network::IpNetwork;

let ip_network = IpNetwork::new(Ipv4Addr::new(192, 168, 1, 0), 24)?;
assert_eq!(ip_network.netmask(), 24);

source

pub fn is_ipv4(&self) -> bool

Returns true if IpNetwork contains Ipv4Network struct.

source

pub fn is_ipv6(&self) -> bool

Returns true if IpNetwork contains Ipv6Network struct.

source

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

Returns true if IpNetwork contains IpAddr. For different network type (for example IpNetwork is IPv6 and IpAddr is IPv4) always returns false.

Examples

use std::net::{IpAddr, Ipv4Addr, Ipv6Addr};
use ip_network::IpNetwork;

let ip_network = IpNetwork::new(Ipv4Addr::new(192, 168, 1, 0), 24)?;
assert!(ip_network.contains(Ipv4Addr::new(192, 168, 1, 25)));
assert!(!ip_network.contains(Ipv6Addr::new(0x2001, 0xdb8, 0, 0, 0, 1, 0, 0)));

source

pub fn is_default_route(&self) -> bool

Returns true if the network is default route, that contains all IP addresses.

source

pub fn is_multicast(&self) -> bool

Returns true if the network is part of multicast network range.

source

pub fn is_documentation(&self) -> bool

Returns true if this is a part of network reserved for documentation.

source

pub fn is_loopback(&self) -> bool

Returns true if this network is inside loopback address range.

source

pub fn is_global(&self) -> bool

Returns true if the network appears to be globally routable.

Trait Implementations

source

impl Clone for IpNetwork

source

fn clone(&self) -> IpNetwork

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Debug for IpNetwork

source

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

Formats the value using the given formatter. Read more

source

impl Display for IpNetwork

source

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

Converts IpNetwork to string in format X.X.X.X/Y for IPv4 and X:X::X/Y for IPv6 (CIDR notation).

Examples

use std::net::Ipv4Addr;
use ip_network::{IpNetwork, Ipv4Network};

let ip_network = IpNetwork::V4(Ipv4Network::new(Ipv4Addr::new(192, 168, 1, 0), 24)?);
assert_eq!(ip_network.to_string(), "192.168.1.0/24");

source

impl From<IpAddr> for IpNetwork

source

fn from(ip: IpAddr) -> Self

Converts IpAddr to IpNetwork with netmask 32 for IPv4 address and 128 for IPv6 address.

source

impl From<Ipv4Addr> for IpNetwork

source

fn from(ip: Ipv4Addr) -> Self

Converts Ipv4Addr to IpNetwork with netmask 32.

source

impl From<Ipv4Network> for IpNetwork

source

fn from(network: Ipv4Network) -> Self

Performs the conversion.

source

impl From<Ipv6Addr> for IpNetwork

source

fn from(ip: Ipv6Addr) -> Self

Converts Ipv46ddr to IpNetwork with netmask 128.

source

impl From<Ipv6Network> for IpNetwork

source

fn from(network: Ipv6Network) -> Self

Performs the conversion.

source

impl FromStr for IpNetwork

source

fn from_str(s: &str) -> Result<IpNetwork, IpNetworkParseError>

Converts string in format IPv4 (X.X.X.X/Y) or IPv6 (X:X::X/Y) CIDR notation to IpNetwork.

Examples

use std::net::Ipv4Addr;
use std::str::FromStr;
use ip_network::{IpNetwork, Ipv4Network};

let ip_network = IpNetwork::from_str("192.168.1.0/24").unwrap();
assert_eq!(ip_network, IpNetwork::V4(Ipv4Network::new(Ipv4Addr::new(192, 168, 1, 0), 24).unwrap()));