IIPAddressRange

Arcus defines the IIPAddressRange interface for representation of consecutive IPAddress objects. It implements both IFormattable and IEnumerable<IPAddress>.

Caution

IIPAddressRange implements IEnumerable<IPAddress>, this means that you should pay particular attention when you may be iterating over large ranges. Such as the full set of IPv6 addresses, which will take a while. A long while. It isn’t recommended.

Hint

When dealing with more than one IPAddress or multiple implementations of IIPAddressRange unless otherwise explicitly stated their AddressFamily, or equivalent properties, must match.

Hint

AddressFamily unless otherwise explicitly stated are expected to be either InterNetwork or InterNetworkV6.

IIPAddressRange is implemented by AbstractIPAddressRange, IPAddress Range, and Subnet.

Functionality Promises

Properties

IIPAddressRange has a handful of useful properties for your use

AddressFamily AddressFamily

The family of the Address Range. You’ll most likely encounter InterNetwork or InterNetworkV6

IPAddress Head

The first IPAddress within the range

bool IsIPv4

Returns true if, and only if, the range is IPv4

bool IsIPv6

Returns true if, and only if, the range is IPv6

bool IsSingleIP

Returns true if, and only if, the range is comprised of only a single IPAddress

BigInteger Length

The number of IPAddress within the range

IPAddress Tail

The last IPAddress within the range

Set Based Operations

At its core an implementation of the IIPAddressRange interface is a range of consecutive IPAddress objects, as such there are some set based operations available.

HeadOverlappedBy

HeadOverlappedBy will return true if the head of this is within the range defined by IIPAddressRange that.

bool HeadOverlappedBy(IIPAddressRange that);

TailOverlappedBy

TailOverlappedBy will return true if the tail of this is within the range defined by IIPAddressRange that.

bool TailOverlappedBy(IIPAddressRange that);

Overlaps

Overlaps will return true if the head or tail of IIPAddressRange that is within the this IIPAddressRange.

bool Overlaps(IIPAddressRange that);

Touches

Touches will return true if the tail of this IIPAddressRange is followed consecutively by the head of IIPAddressRange that, or if the tail of IIPAddressRange that is followed consecutively by the head of this IIPAddressRange without any additional IPAddress objects in between.

bool Touches(IIPAddressRange that);

Length and TryGetLength

The IIPAddressRange implements IEnumerable<IPAddress>, but because of the possible size of this range it may not always be safe to attempt to do a count or get the length in a traditional manner. A BigInteger Length property is provided but not always ideal but often necessary. Keep in mind the full range of IPv6 Addresses is \(2^{128}\) in length. That’s \(3.4\times10^{38}\) or over 340 undecillion. Certainly not something that should be iterated in order to be counted.

Given that the BigInteger object isn’t the best thing to drag around Arcus uses the magic of math and with the various implementations of TryGetLength to get the length of the range in a more portable manner if possible, returning true on success and outing the more reasonable int or long length.

bool TryGetLength(out int length);

bool TryGetLength(out long length);