// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the Apache 2.0 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
{
///
/// Returns the only element of an async-enumerable sequence, or a default value if the async-enumerable sequence is empty; this method reports an exception if there is more than one element in the async-enumerable sequence.
///
/// 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.
/// Sequence containing the single element in the async-enumerable sequence, or a default value if no such element exists.
/// is null.
/// (Asynchronous) The source sequence contains more than one element.
public static ValueTask SingleOrDefaultAsync(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)
{
if (source is IList list)
{
return list.Count switch
{
0 => default!,
1 => list[0],
_ => throw Error.MoreThanOneElement(),
};
}
await using (var e = source.GetConfiguredAsyncEnumerator(cancellationToken, false))
{
if (!await e.MoveNextAsync())
{
return default!;
}
var result = e.Current;
if (!await e.MoveNextAsync())
{
return result;
}
}
throw Error.MoreThanOneElement();
}
}
///
/// Returns the only element of an async-enumerable sequence that matches the predicate, or a default value if no such element exists; this method reports an exception if there is more than one element in the async-enumerable sequence.
///
/// 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.
/// Sequence containing the single 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.
/// (Asynchronous) The sequence contains more than one element that satisfies the condition in the predicate.
public static ValueTask SingleOrDefaultAsync(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)
{
await using (var e = source.GetConfiguredAsyncEnumerator(cancellationToken, false))
{
while (await e.MoveNextAsync())
{
var result = e.Current;
if (predicate(result))
{
while (await e.MoveNextAsync())
{
if (predicate(e.Current))
{
throw Error.MoreThanOneElement();
}
}
return result;
}
}
}
return default!;
}
}
internal static ValueTask SingleOrDefaultAwaitAsyncCore(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)
{
await using (var e = source.GetConfiguredAsyncEnumerator(cancellationToken, false))
{
while (await e.MoveNextAsync())
{
var result = e.Current;
if (await predicate(result).ConfigureAwait(false))
{
while (await e.MoveNextAsync())
{
if (await predicate(e.Current).ConfigureAwait(false))
{
throw Error.MoreThanOneElement();
}
}
return result;
}
}
}
return default!;
}
}
#if !NO_DEEP_CANCELLATION
internal static ValueTask SingleOrDefaultAwaitWithCancellationAsyncCore(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)
{
await using (var e = source.GetConfiguredAsyncEnumerator(cancellationToken, false))
{
while (await e.MoveNextAsync())
{
var result = e.Current;
if (await predicate(result, cancellationToken).ConfigureAwait(false))
{
while (await e.MoveNextAsync())
{
if (await predicate(e.Current, cancellationToken).ConfigureAwait(false))
{
throw Error.MoreThanOneElement();
}
}
return result;
}
}
}
return default!;
}
}
#endif
}
}