MoreLINQ

Links

• README
• Examples
• Documentation

Add the package to a project

dotnet add package MoreLINQ

Operators

Batch

Batches the source sequence into sized buckets.

Enumerable .Range(1, 10) .Batch(3); // split the sequence into sequences of max length 3 // [1, 2, 3] // [4, 5, 6] // [7, 8, 9] // [10]

Cartesian

Returns the Cartesian product of two or more sequences by combining each element from the sequences and applying a user-defined projection to the set.

new[] { "A", "B" } .Cartesian( new[] { 1, 2 }, (x, y) => $"{x}{y}"); // A1 // A2 // B1 // B2

DistinctBy

Returns all distinct elements of the given source, where "distinctness" is determined via a projection and the default equality comparer for the projected type.

var items = new[] { new { Id = 1, Name = "One" }, new { Id = 2, Name = "Two" }, new { Id = 3, Name = "One" }, new { Id = 2, Name = "Two again" } }; items.DistinctBy(x => x.Id); // 1 2 3 items.DistinctBy(x => x.Name); // 1 2 2

ExceptBy

Returns the set of elements in the first sequence which aren't in the second sequence, according to a given key selector.

var items2 = new[] { new { Id = 2, Name = "One" } }; items.ExceptBy(items2, x => x.Id); // 1 3 items.ExceptBy(items2, x => x.Name); // 2 2

FallbackIfEmpty

Returns the elements of a sequence and falls back to another if the original sequence is empty.

var integers = Array.Empty<int>(); integers.FallbackIfEmpty(new[] { 1, 2 }); integers.FallbackIfEmpty(1); // int[] { 1 } integers.FallbackIfEmpty(1, 2); // int[] { 1, 2 }

Left / Right / Full join

var a1 = new[] {1, 2, 3}; var a2 = new[] {1, 2, 4}; var lj = a1.LeftJoin( a2, x => x, // a1 key selector x => x, // a2 key selector x => (x, 0), // selector when a1 element doesn't match a2 element (x, y) => (x, y)) // match selector .ToArray(); // (1, 1) (2, 2) (3 ,0) var fj = a1.FullJoin( a2, x => x, // a1 key selector x => x, // a2 key selector x => (x, 0), // selector when a1 element doesn't match a2 element x => (0, x), // selector when a2 element doesn't match a1 element (x, y) => (x, y)) // match selector .ToArray(); // (1, 1) (2, 2) (3 ,0) (0, 4)

• Left join
• Full join

Ambiguous call between Linq.Enumerable.ToHashSet and MoreLinq.MoreEnumerable.ToHashSet

Workaround: move the MoreLinq using statement inside the namespace.

// using MoreLinq; namespace MyNamespace; using MoreLinq;