utte.numberset 2.0.0

NumberSet

Generic sets for numbers or numberlike objects and Union, Intersection and Difference for them. The sets track if they contain their endpoints and thus wether they are Open, Closed or neither.

Content

Three interfaces are included:

• IBoundedSet<T> - Interface for building sets of numberlike objects of type T. The sets are immutable and every operation on them creates new sets, T has to implement IAdditionOperators<T, T, T>, ISubtractionOperators<T, T, T>, IComparisonOperators<T, T, bool> The structure of the sets are INumberSet<T> which contains a collection of INumberSetElement<T> A single T instance is considered a point

• INumberSetElement<T> - Interface implementing IBoundedSet<T> for constructing elements of a set which is a set in itself. The interface is used as part of INumberSet. T has to implement IAdditionOperators<T, T, T>, ISubtractionOperators<T, T, T>, IComparisonOperators<T, T, bool>

• INumberSet<T> - Interface implementing IBoundedSet<T> for constructing sets of numberlike objects of type T. It is built of a collection of INumberSetElement and is immutable. Every INumberSetElement in the collection should be disjunct and sorted in order. T has to implement IAdditionOperators<T, T, T>, ISubtractionOperators<T, T, T>, IComparisonOperators<T, T, bool>

Two classes are included:

• NumberSetElement<T> - Implementation of INumberSetElement<T>

• NumberSet<T> - Implementation of INumberSet<T>

Usage

Sets can be created by casts, parse string or the Create method. At creation it should be specified wether each NumberSetElement should contain its boundaries. A ( or ) means the boundary is not included while a [ or ] means it is for casts/parsing. In the Create method it is set using a boolean.

NumberSet<double> set1 = "(0.3, 2.1]";
NumberSet<double> set2 = "(1.8, 3.6]";

Console.WriteLine("Set1: " + set1.ToString());

Console.WriteLine("Set2: " + set2.ToString());

var unionSet = set1.Union(set2);

Console.WriteLine("Union: " + unionSet.ToString());

var intersectionSet = set1.Intersection(set2);

Console.WriteLine("Intersection: " + intersectionSet.ToString());

var differenceSet = set1.Difference(set2);

Console.WriteLine("Difference: " + differenceSet.ToString());

This code will print the following to the console:

Set1: (0.3, 2.1]
Set2: (1.8, 3.6]
Union: (0.3, 3.6]
Intersection: (1.8, 2.1]
Difference: (0.3, 1.8]

A NumberSet can contain several NumberSetElement by simply writing them in the string like "(0.3, 2.1]; (1.8, 3.6]". Each will be unioned and ordered as appropriate.

Additional documentation

The code can be found here: NumberSet repository.