Philiprehberger.IpRange 0.3.0

Philiprehberger.IpRange

Parse and match IP addresses against CIDR ranges with IPv4 and IPv6 support.

Installation

dotnet add package Philiprehberger.IpRange

Usage

Parsing and Matching CIDR Ranges

using System.Net;
using Philiprehberger.IpRange;

// Parse a CIDR range and check membership
var range = IpRange.Parse("192.168.1.0/24");
bool match = range.Contains(IPAddress.Parse("192.168.1.42")); // true

// Inspect range boundaries
var cidr = IpCidrRange.Parse("10.0.0.0/8");
Console.WriteLine(cidr.FirstAddress); // 10.0.0.0
Console.WriteLine(cidr.LastAddress);  // 10.255.255.255
Console.WriteLine(cidr.PrefixLength); // 8

Matching Against Multiple Ranges

using System.Net;
using Philiprehberger.IpRange;

// Parse comma-separated CIDR ranges into a list
var list = IpRangeList.Parse("10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16");
bool allowed = list.Contains(IPAddress.Parse("172.16.5.1")); // true

// IPv6 ranges work the same way
var ipv6Range = IpCidrRange.Parse("fe80::/10");
bool isLinkLocal = ipv6Range.Contains(IPAddress.Parse("fe80::1")); // true

Checking Range Overlap

using Philiprehberger.IpRange;

var rangeA = IpCidrRange.Parse("192.168.0.0/16");
var rangeB = IpCidrRange.Parse("192.168.1.0/24");
var rangeC = IpCidrRange.Parse("10.0.0.0/8");

bool overlaps = rangeA.Overlaps(rangeB); // true — rangeB is within rangeA
bool separate = rangeA.Overlaps(rangeC); // false — completely disjoint

Safe Parsing and Address Counts

using Philiprehberger.IpRange;

// TryParse never throws — returns false on invalid input
if (IpCidrRange.TryParse("10.0.0.0/8", out var range))
{
    System.Numerics.BigInteger total = range.AddressCount; // 16777216
}

if (IpRangeList.TryParse("10.0.0.0/8, 172.16.0.0/12", out var list))
{
    Console.WriteLine(list!.Count); // 2
}

Classifying IP Addresses

using System.Net;
using Philiprehberger.IpRange;

// Get the full classification for an address
var classification = IpClassification.Classify(IPAddress.Parse("192.168.1.1"));
Console.WriteLine(classification); // Private

// Quick checks via IpRange helpers
bool isPrivate  = IpRange.IsPrivate(IPAddress.Parse("10.0.0.1"));    // true
bool isLoopback = IpRange.IsLoopback(IPAddress.Parse("127.0.0.1")); // true

API

IpRange

IpCidrRange

IpRangeList

IpClassification

Development

dotnet build src/Philiprehberger.IpRange.csproj --configuration Release

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT