// 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.Diagnostics; using System.Threading; using System.Threading.Tasks; namespace System.Linq { public static partial class AsyncEnumerable { public static IAsyncEnumerable Except(this IAsyncEnumerable first, IAsyncEnumerable second) { if (first == null) throw Error.ArgumentNull(nameof(first)); if (second == null) throw Error.ArgumentNull(nameof(second)); return new ExceptAsyncIterator(first, second, EqualityComparer.Default); } public static IAsyncEnumerable Except(this IAsyncEnumerable first, IAsyncEnumerable second, IEqualityComparer comparer) { if (first == null) throw Error.ArgumentNull(nameof(first)); if (second == null) throw Error.ArgumentNull(nameof(second)); if (comparer == null) throw Error.ArgumentNull(nameof(comparer)); return new ExceptAsyncIterator(first, second, comparer); } private sealed class ExceptAsyncIterator : AsyncIterator { private readonly IEqualityComparer _comparer; private readonly IAsyncEnumerable _first; private readonly IAsyncEnumerable _second; private IAsyncEnumerator _firstEnumerator; private Set _set; public ExceptAsyncIterator(IAsyncEnumerable first, IAsyncEnumerable second, IEqualityComparer comparer) { Debug.Assert(first != null); Debug.Assert(second != null); Debug.Assert(comparer != null); _first = first; _second = second; _comparer = comparer; } public override AsyncIterator Clone() { return new ExceptAsyncIterator(_first, _second, _comparer); } public override async ValueTask DisposeAsync() { if (_firstEnumerator != null) { await _firstEnumerator.DisposeAsync().ConfigureAwait(false); _firstEnumerator = null; } _set = null; await base.DisposeAsync().ConfigureAwait(false); } protected override async ValueTask MoveNextCore(CancellationToken cancellationToken) { // NB: Earlier implementations of this operator constructed the set for the second source concurrently // with the first MoveNextAsync call on the first source. This resulted in an unexpected source of // concurrency, which isn't a great default behavior because it's very hard to suppress or control // this behavior. switch (state) { case AsyncIteratorState.Allocated: _set = await AsyncEnumerableHelpers.ToSet(_second, _comparer, cancellationToken).ConfigureAwait(false); _firstEnumerator = _first.GetAsyncEnumerator(cancellationToken); state = AsyncIteratorState.Iterating; goto case AsyncIteratorState.Iterating; case AsyncIteratorState.Iterating: bool moveNext; do { moveNext = await _firstEnumerator.MoveNextAsync().ConfigureAwait(false); if (moveNext) { var item = _firstEnumerator.Current; if (_set.Add(item)) { current = item; return true; } } } while (moveNext); await DisposeAsync().ConfigureAwait(false); break; } return false; } } } }