// Licensed to the .NET Foundation under one or more agreements. // The .NET Foundation licenses this file to you under the MIT License. // See the LICENSE file in the project root for more information. using System.Collections.Generic; using System.Threading; using System.Threading.Tasks; namespace System.Linq { public static partial class AsyncEnumerable { #if INCLUDE_SYSTEM_LINQ_ASYNCENUMERABLE_DUPLICATES // https://learn.microsoft.com/en-us/dotnet/api/system.linq.asyncenumerable.lastordefaultasync?view=net-9.0-pp#system-linq-asyncenumerable-lastordefaultasync-1(system-collections-generic-iasyncenumerable((-0))-system-threading-cancellationtoken) /// /// Returns the last element of an async-enumerable sequence, or a default value if no such element exists. /// /// The type of the elements in the source sequence. /// Source async-enumerable sequence. /// The optional cancellation token to be used for cancelling the sequence at any time. /// ValueTask containing the last element in the async-enumerable sequence, or a default value if no such element exists. /// is null. public static ValueTask LastOrDefaultAsync(this IAsyncEnumerable source, CancellationToken cancellationToken = default) { if (source == null) throw Error.ArgumentNull(nameof(source)); return Core(source, cancellationToken); static async ValueTask Core(IAsyncEnumerable source, CancellationToken cancellationToken) { var last = await TryGetLast(source, cancellationToken).ConfigureAwait(false); return last.HasValue ? last.Value : default; } } // https://learn.microsoft.com/en-us/dotnet/api/system.linq.asyncenumerable.lastordefaultasync?view=net-9.0-pp#system-linq-asyncenumerable-lastordefaultasync-1(system-collections-generic-iasyncenumerable((-0))-system-func((-0-system-boolean))-system-threading-cancellationtoken) /// /// Returns the last element of an async-enumerable sequence that satisfies the condition in the predicate, or a default value if no such element exists. /// /// The type of the elements in the source sequence. /// Source async-enumerable sequence. /// A predicate function to evaluate for elements in the source sequence. /// The optional cancellation token to be used for cancelling the sequence at any time. /// ValueTask containing the last element in the async-enumerable sequence that satisfies the condition in the predicate, or a default value if no such element exists. /// or is null. public static ValueTask LastOrDefaultAsync(this IAsyncEnumerable source, Func predicate, CancellationToken cancellationToken = default) { if (source == null) throw Error.ArgumentNull(nameof(source)); if (predicate == null) throw Error.ArgumentNull(nameof(predicate)); return Core(source, predicate, cancellationToken); static async ValueTask Core(IAsyncEnumerable source, Func predicate, CancellationToken cancellationToken) { var last = await TryGetLast(source, predicate, cancellationToken).ConfigureAwait(false); return last.HasValue ? last.Value : default; } } #endif // INCLUDE_SYSTEM_LINQ_ASYNCENUMERABLE_DUPLICATES // https://learn.microsoft.com/en-us/dotnet/api/system.linq.asyncenumerable.lastordefaultasync?view=net-9.0-pp#system-linq-asyncenumerable-lastordefaultasync-1(system-collections-generic-iasyncenumerable((-0))-system-func((-0-system-threading-cancellationtoken-system-threading-tasks-valuetask((system-boolean))))-system-threading-cancellationtoken) /// /// Returns the last element of an async-enumerable sequence that satisfies the condition in the predicate, or a default value if no such element exists. /// /// The type of the elements in the source sequence. /// Source async-enumerable sequence. /// An asynchronous predicate function to evaluate for elements in the source sequence. /// The optional cancellation token to be used for cancelling the sequence at any time. /// ValueTask containing the last element in the async-enumerable sequence that satisfies the condition in the predicate, or a default value if no such element exists. /// or is null. [GenerateAsyncOverload] [Obsolete("Use LastOrDefaultAsync. IAsyncEnumerable LINQ is now in System.Linq.AsyncEnumerable, and the LastOrDefaultAwaitAsync functionality now exists as overloads of LastOrDefaultAsync.")] private static ValueTask LastOrDefaultAwaitAsyncCore(this IAsyncEnumerable source, Func> predicate, CancellationToken cancellationToken = default) { if (source == null) throw Error.ArgumentNull(nameof(source)); if (predicate == null) throw Error.ArgumentNull(nameof(predicate)); return Core(source, predicate, cancellationToken); static async ValueTask Core(IAsyncEnumerable source, Func> predicate, CancellationToken cancellationToken) { var last = await TryGetLast(source, predicate, cancellationToken).ConfigureAwait(false); return last.HasValue ? last.Value : default; } } #if !NO_DEEP_CANCELLATION [GenerateAsyncOverload] [Obsolete("Use LastOrDefaultAsync. IAsyncEnumerable LINQ is now in System.Linq.AsyncEnumerable, and the LastOrDefaultAwaitWithCancellationAsync functionality now exists as overloads of LastOrDefaultAsync.")] private static ValueTask LastOrDefaultAwaitWithCancellationAsyncCore(this IAsyncEnumerable source, Func> predicate, CancellationToken cancellationToken = default) { if (source == null) throw Error.ArgumentNull(nameof(source)); if (predicate == null) throw Error.ArgumentNull(nameof(predicate)); return Core(source, predicate, cancellationToken); static async ValueTask Core(IAsyncEnumerable source, Func> predicate, CancellationToken cancellationToken) { var last = await TryGetLast(source, predicate, cancellationToken).ConfigureAwait(false); return last.HasValue ? last.Value : default; } } #endif private static ValueTask> TryGetLast(IAsyncEnumerable source, CancellationToken cancellationToken) { if (source is IList list) { var count = list.Count; if (count > 0) { return new ValueTask>(new Maybe(list[count - 1])); } } else if (source is IAsyncPartition p) { return p.TryGetLastAsync(cancellationToken); } else { return Core(source, cancellationToken); static async ValueTask> Core(IAsyncEnumerable source, CancellationToken cancellationToken) { var last = default(TSource)!; // NB: Only matters when hasLast is set to true. var hasLast = false; await foreach (var item in source.WithCancellation(cancellationToken).ConfigureAwait(false)) { hasLast = true; last = item; } return hasLast ? new Maybe(last!) : new Maybe(); } } return new ValueTask>(new Maybe()); } private static async ValueTask> TryGetLast(IAsyncEnumerable source, Func predicate, CancellationToken cancellationToken) { var last = default(TSource)!; // NB: Only matters when hasLast is set to true. var hasLast = false; await foreach (var item in source.WithCancellation(cancellationToken).ConfigureAwait(false)) { if (predicate(item)) { hasLast = true; last = item; } } return hasLast ? new Maybe(last!) : new Maybe(); } private static async ValueTask> TryGetLast(IAsyncEnumerable source, Func> predicate, CancellationToken cancellationToken) { var last = default(TSource)!; // NB: Only matters when hasLast is set to true. var hasLast = false; await foreach (var item in source.WithCancellation(cancellationToken).ConfigureAwait(false)) { if (await predicate(item).ConfigureAwait(false)) { hasLast = true; last = item; } } return hasLast ? new Maybe(last!) : new Maybe(); } #if !NO_DEEP_CANCELLATION private static async ValueTask> TryGetLast(IAsyncEnumerable source, Func> predicate, CancellationToken cancellationToken) { var last = default(TSource)!; // NB: Only matters when hasLast is set to true. var hasLast = false; await foreach (var item in source.WithCancellation(cancellationToken).ConfigureAwait(false)) { if (await predicate(item, cancellationToken).ConfigureAwait(false)) { hasLast = true; last = item; } } return hasLast ? new Maybe(last!) : new Maybe(); } #endif } }