dotnet 10 新的 LINQ 方法 Shuffle
Intro
dotnet 10 中引入了一个新的 LINQ 方法 Shuffle 可以将一个集合中的元素随机洗牌返回
New API
新引入的 API 定义如下：
namespace System.Linq;
publicstaticclassEnumerable
{
publicstatic IEnumerable<T> Shuffle<T>(this IEnumerable<T> source) { }
}
publicstaticclassAsyncEnumerable
{
publicstatic IAsyncEnumerable<T> Shuffle<T>(this IAsyncEnumerable<T> source) { }
}
publicstaticclassQueryable
{
publicstatic IQueryable<T> Shuffle<T>(this IQueryable<T> source) { }
}
Sample
var source = Enumerable.Range(1, 5).ToArray();
Console.WriteLine(string.Join(",", source));
source.Shuffle();
Console.WriteLine(string.Join(",", source));
大家可以先猜一下输出结果会是什么，输出结果如下：
从上面的输出结果可以看得出来，原来的数组 source 中的元素并未改变，这是因为 Shuffle 方法并不会改变原有数组，而是返回一个新的 IEnumerable 对象
我们再来做一些测试，看看返回的数据，测试代码如下：
var source = Enumerable.Range(1, 5).ToArray();
Console.WriteLine(string.Join(",", source.Shuffle()));
Console.WriteLine(string.Join(",", source.Shuffle().Take(3)));
Console.WriteLine(string.Join(",", source.Shuffle().Take(3)));
Console.WriteLine(string.Join(",", source.Shuffle().Take(6)));
输出结果如下：
那么如果是同一个 Shuffle 返回值，两次会不会一样呢，我们也来做一个测试
var source = Enumerable.Range(1, 5).ToArray();
var shuffled = source.Shuffle();
Console.WriteLine(string.Join(",", shuffled));
Console.WriteLine(string.Join(",", shuffled));
输出结果如下：
可以看到即使是同一个 shuffle 返回值的对象，每次使用时也不相同，实际数据的填充是遍历时获取的，并不是提前生成好的，确定的
如果需要对数组进行重排可以使用 .NET 8 引入的 Random.Shuffle 方法，使用示例如下：
Console.WriteLine("Random.Shared.Shuffle(array) sample");
var array = Enumerable.Range(1, 10).ToArray();
Console.WriteLine(string.Join(",", array));
Random.Shared.Shuffle(array);
Console.WriteLine(string.Join(",", array));
输出结果如下：
Random.Shared.Shuffle output
References
-
https://github.com/dotnet/runtime/issues/111221 -
https://github.com/dotnet/runtime/pull/112173 -
https://github.com/dotnet/runtime/issues/73864 -
.NET 8 Preview 1 中新增的 Random 方法