SuperLinq

Name	Status	History
GitHub Actions

LINQ to Objects is missing a few desirable features.

This project enhances LINQ to Objects with extra methods, in a manner which keeps to the spirit of LINQ.

Methods are provided to extend both IEnumerable<T> (via SuperLinq package) and IAsyncEnumerable<T> (via SuperLinq.Async package).

SuperLinq

SuperLinq is available for download and installation as a NuGet package.

The documentation for the SuperLinq methods can be found here.

SuperLinq.Async

SuperLinq.Async is available for download and installation as a NuGet package.

The documentation for the SuperLinq.Async methods can be found here.

Operators

<details> <summary> Sorting Data </summary>

A sorting operation orders the elements of a sequence based on one or more attributes. The first sort criterion performs a primary sort on the elements. By specifying a second sort criterion, you can sort the elements within each primary sort group.

Methods

Method Name	Description	Sync doc	Async doc
OrderBy	Sorts the elements of a sequence in a particular direction (ascending, descending) according to a key	link	link
ThenBy	Performs a subsequent ordering of elements in a sequence in a particular direction (ascending, descending) according to a key	link	link
PartialSort	Executes a partial sort of the top N elements of a sequence. If N is less than the total number of elements in the sequence, then this method will improve performance.	link	link
PartialSortBy	Executes a partial sort of the top N elements of a sequence according to a key. If N is less than the total number of elements in the sequence, then this method will improve performance.	link	link
DensePartialSort	Executes a partial sort of the top N elements of a sequence, including ties. If N is less than the total number of elements in the sequence, then this method will improve performance.	link	link
DensePartialSortBy	Executes a partial sort of the top N elements of a sequence, including ties according to a key. If N is less than the total number of elements in the sequence, then this method will improve performance.	link	link
Shuffle	Sorts the elements of a sequence in a random order.	link	⏱(#20)
RandomSubset	Sorts a given number of elements of a sequence in a random order.	link	⏱(#20)

</details> <details> <summary> Set Operations </summary>

Set operations in LINQ refer to query operations that produce a result set that is based on the presence or absence of equivalent elements within the same or separate collections (or sets).

Methods

Method Name	Description	Sync doc	Async doc
DistinctBy	Removes duplicate values from a collection.	link	link
Duplicates	Returns the sequence of elements that are in the source sequence more than once.	link	link
ExceptBy	Returns the set difference, which means the elements of one collection that do not appear in a second collection.	link	link

</details> <details> <summary> Filtering Data </summary>

Filtering refers to the operation of restricting the result set to contain only those elements that satisfy a specified condition. It is also known as selection.

Methods

Method Name	Description	Sync doc	Async doc
Choose	Filters a sequence based on a projection method that returns a tuple containing bool value and a new projected value.	link	link
Where	Filters a sequence of values based on an enumeration of boolean values.	link	link
WhereLead	Filters a sequence of values based on a predicate evaluated on the current value and a leading value.	link	link
WhereLag	Filters a sequence of values based on a predicate evaluated on the current value and a lagging value.	link	link

</details> <details> <summary> Quantifier Operations </summary>

Quantifier operations return a boolean value that indicates whether the sequence length matches some criteria.

Methods

Method Name	Description	Sync doc	Async doc
AtLeast	Determines whether or not the number of elements in the sequence is greater than or equal to the given integer.	link	link
AtMost	Determines whether or not the number of elements in the sequence is lesser than or equal to the given integer.	link	link
CountBetween	Determines whether or not the number of elements in the sequence is between an inclusive range of minimum and maximum integers.	link	link
Exactly	Determines whether or not the number of elements in the sequence is equals to the given integer.	link	link
TrySingle	Determines the cardinality of the sequence in the set { 0, 1, >1 }.	link	link
HasDuplicates	Determines whether the sequence contains duplicates	link	link

</details> <details> <summary> Projection Operations </summary>

Projection refers to the operation of transforming an object into a new form that may contain related information.

Methods

Method Name	Description	Sync doc	Async doc
EquiZip	Joins the corresponding elements of up to four sequences producing a sequence of tuples containing them, asserting that all sequences have exactly the same length.	link	link
ZipLongest	Joins the corresponding elements of up to four sequences producing a sequence of tuples containing them, using default values for sequences that are shorter than the longest sequence.	link	link
ZipShortest	Joins the corresponding elements of up to four sequences producing a sequence of tuples containing them, which has the same length as the shortest sequence.	link	link
CountDown	Provides a countdown counter for a given count of elements at the tail of the sequence.	link	link
TagFirstLast	Provides bool values indicating for each element whether it is the first or last element of the sequence.	link	link
Index	Provides an int value indicating the current index of each element of the sequence.	link	link
IndexBy	Provides an int value indicating the current index of each element of the sequence within a group of items defined by a common attribute.	link	link
Lag	Joins each element of the sequence with n-th previous element of the same sequence.	link	link
Lead	Joins each element of the sequence with n-th next element of the same sequence.	link	link
Rank	Provides an int value indicating the current rank of each element of the sequence.	link	link
RankBy	Provides an int value indicating the current rank of each element of the sequence according to a key.	link	link
DenseRank	Provides an int value indicating the current rank of each element of the sequence, counting ties as a single element.	link	link
DenseRankBy	Provides an int value indicating the current rank of each element of the sequence according to a key, counting ties as a single element.	link	link
Evaluate	Transforms a sequence of functions to a sequence of values returned by the functions.	link	N/A[^1]
ZipMap	Applies a function to each element in a sequence and returns a sequence of tuples containing both the original item as well as the function result.	link