CapitalSix.Linq.Extensions 9.0.0

Linq Extensions

A collection of reusable Linq extensions.

Chunk extensions

The chunk extension splits a collection in preferred size parts and returns the "Chuncks" in a list.

var list = new List<int>();
for (var i = 0; i < 21000; i++) list.Add(i);

var chunks = list.Chunks(1800);

chunks contains a list of 12 lists, which are each 1800 elements except for the last, which contains the 1200 remaining elements.

Group extensions

This extension groups elements based on a key definition and on a equality comparer.

var list = new List<string>()
{
    "Monkey",
    "Disco",
    "monkey",
    "banana",
    " Monkey",
    "Banana",
    "tree"
};
var grouped = list.Group(new CaseInsensitiveComparer());

Suppose that the CaseInsensitiveComparere compares on trimmed and lowercase values, than this results in a dictionary with 4 pairs:

• "Monkey": { "Monkey", "monkey", " Monkey" },
• "Disco": { "Disco" },
• "banana": { "banana", "Banana" },
• "tree": { "tree" }

Duplicate extensions

This extension finds duplicates in a list an collects all duplicates in a dictionary.

var list = new List<string>()
{
    "Monkey",
    "Disco",
    "monkey",
    "banana",
    " Monkey",
    "Banana",
    "tree"
};
var duplicates = list.Duplicates(new CaseInsensitiveComparer());

Suppose that the CaseInsensitiveComparere compares on trimmed and lowercase values, than this results in a dictionary with 2 pairs:

• "Monkey": { "Monkey", "monkey", " Monkey" },
• "banana": { "banana", "Banana" }

Enumerable extensions

This extensions contists of 3 extension methods:

• AsCancellable
• WhenEachAsync
• SelectManyAsync

AsCancellable

This method enables an enumerator to iterate and abort when a cancellation token is triggered

var list = new List<int>();
for (var i = 0; i < 21000; i++) list.Add(i);

// This iteration cancels when the cancellation
// token is triggered
var result = list
  .AsCancellable(cancellationToken)
  .Select(i = i + 1)
  .ToArray();

WhenEachAsync

This method asynchronically waits until all tasks are finished. The individual results are returned in an IAsyncEnumerable as soon as they are ready.

SelectManyAsync

This method works similar to Linq's SelectMany, but asynchronically.