-
-
Notifications
You must be signed in to change notification settings - Fork 9
/
RankBy.cs
99 lines (91 loc) · 5.47 KB
/
RankBy.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
namespace SuperLinq.Async;
public static partial class AsyncSuperEnumerable
{
/// <summary>
/// Ranks each item in the sequence in ascending order by a specified key
/// using a default comparer. The rank is equal to index + 1 of the first
/// element of the item's equality set.
/// </summary>
/// <typeparam name="TSource">The type of the elements in the source sequence</typeparam>
/// <typeparam name="TKey">The type of the key used to rank items in the sequence</typeparam>
/// <param name="source">The sequence of items to rank</param>
/// <param name="keySelector">A key selector function which returns the value by which to rank items in the sequence</param>
/// <returns>A sorted sequence of items and their rank.</returns>
/// <exception cref="ArgumentNullException"><paramref name="source"/> is <see langword="null"/>.</exception>
/// <exception cref="ArgumentNullException"><paramref name="keySelector"/> is <see langword="null"/>.</exception>
public static IAsyncEnumerable<(TSource item, int rank)> RankBy<TSource, TKey>(
this IAsyncEnumerable<TSource> source, Func<TSource, TKey> keySelector)
{
ArgumentNullException.ThrowIfNull(source);
ArgumentNullException.ThrowIfNull(keySelector);
return RankCore(source, keySelector, comparer: null, isDense: false);
}
/// <summary>
/// Ranks each item in the sequence in the order defined by <paramref name="sortDirection"/>
/// by a specified key using a default comparer. The rank is equal to index + 1 of the first
/// element of the item's equality set.
/// </summary>
/// <typeparam name="TSource">The type of the elements in the source sequence</typeparam>
/// <typeparam name="TKey">The type of the key used to rank items in the sequence</typeparam>
/// <param name="source">The sequence of items to rank</param>
/// <param name="keySelector">A key selector function which returns the value by which to rank items in the sequence</param>
/// <param name="sortDirection">Defines the ordering direction for the sequence</param>
/// <returns>A sorted sequence of items and their rank.</returns>
/// <exception cref="ArgumentNullException"><paramref name="source"/> is <see langword="null"/>.</exception>
/// <exception cref="ArgumentNullException"><paramref name="keySelector"/> is <see langword="null"/>.</exception>
public static IAsyncEnumerable<(TSource item, int rank)> RankBy<TSource, TKey>(
this IAsyncEnumerable<TSource> source,
Func<TSource, TKey> keySelector,
OrderByDirection sortDirection)
{
ArgumentNullException.ThrowIfNull(source);
ArgumentNullException.ThrowIfNull(keySelector);
return RankCore(source, keySelector, comparer: null, isDense: false, sortDirection);
}
/// <summary>
/// Ranks each item in the sequence in ascending order by a specified key
/// using a caller-supplied comparer. The rank is equal to index + 1 of the first
/// element of the item's equality set.
/// </summary>
/// <typeparam name="TSource">The type of the elements in the source sequence</typeparam>
/// <typeparam name="TKey">The type of the key used to rank items in the sequence</typeparam>
/// <param name="source">The sequence of items to rank</param>
/// <param name="keySelector">A key selector function which returns the value by which to rank items in the sequence</param>
/// <param name="comparer">An object that defines the comparison semantics for keys used to rank items</param>
/// <returns>A sorted sequence of items and their rank.</returns>
/// <exception cref="ArgumentNullException"><paramref name="source"/> is <see langword="null"/>.</exception>
/// <exception cref="ArgumentNullException"><paramref name="keySelector"/> is <see langword="null"/>.</exception>
public static IAsyncEnumerable<(TSource item, int rank)> RankBy<TSource, TKey>(
this IAsyncEnumerable<TSource> source,
Func<TSource, TKey> keySelector,
IComparer<TKey> comparer)
{
ArgumentNullException.ThrowIfNull(source);
ArgumentNullException.ThrowIfNull(keySelector);
return RankCore(source, keySelector, comparer, isDense: false);
}
/// <summary>
/// Ranks each item in the sequence in the order defined by <paramref name="sortDirection"/>
/// by a specified key using a caller-supplied comparer. The rank is equal to index + 1 of the first
/// element of the item's equality set.
/// </summary>
/// <typeparam name="TSource">The type of the elements in the source sequence</typeparam>
/// <typeparam name="TKey">The type of the key used to rank items in the sequence</typeparam>
/// <param name="source">The sequence of items to rank</param>
/// <param name="keySelector">A key selector function which returns the value by which to rank items in the sequence</param>
/// <param name="comparer">An object that defines the comparison semantics for keys used to rank items</param>
/// <param name="sortDirection">Defines the ordering direction for the sequence</param>
/// <returns>A sorted sequence of items and their rank.</returns>
/// <exception cref="ArgumentNullException"><paramref name="source"/> is <see langword="null"/>.</exception>
/// <exception cref="ArgumentNullException"><paramref name="keySelector"/> is <see langword="null"/>.</exception>
public static IAsyncEnumerable<(TSource item, int rank)> RankBy<TSource, TKey>(
this IAsyncEnumerable<TSource> source,
Func<TSource, TKey> keySelector,
IComparer<TKey> comparer,
OrderByDirection sortDirection)
{
ArgumentNullException.ThrowIfNull(source);
ArgumentNullException.ThrowIfNull(keySelector);
return RankCore(source, keySelector, comparer, isDense: false, sortDirection);
}
}