Add polyfills for Queue<T>.TryDequeue(...) and Queue<T>.TryPeek(...)

PolyShim.Tests/NetCore20/QueueTests.cs

@@ -0,0 +1,101 @@
+using System.Collections.Generic;
+using FluentAssertions;
+using Xunit;
+
+namespace PolyShim.Tests.NetCore20;
+
+public class QueueTests
+{
+    [Fact]
+    public void TryDequeue_WithElements_Test()
+    {
+        // Arrange
+        var queue = new Queue<int>();
+        queue.Enqueue(1);
+        queue.Enqueue(2);
+        queue.Enqueue(3);
+
+        // Act
+        var result1 = queue.TryDequeue(out var value1);
+        var result2 = queue.TryDequeue(out var value2);
+        var result3 = queue.TryDequeue(out var value3);
+
+        // Assert
+        result1.Should().BeTrue();
+        value1.Should().Be(1);
+        result2.Should().BeTrue();
+        value2.Should().Be(2);
+        result3.Should().BeTrue();
+        value3.Should().Be(3);
+        queue.Should().BeEmpty();
+    }
+
+    [Fact]
+    public void TryDequeue_EmptyQueue_Test()
+    {
+        // Arrange
+        var queue = new Queue<int>();
+
+        // Act
+        var result = queue.TryDequeue(out var value);
+
+        // Assert
+        result.Should().BeFalse();
+        value.Should().Be(0);
+        queue.Should().BeEmpty();
+    }
+
+    [Fact]
+    public void TryPeek_WithElements_Test()
+    {
+        // Arrange
+        var queue = new Queue<int>();
+        queue.Enqueue(1);
+        queue.Enqueue(2);
+        queue.Enqueue(3);
+
+        // Act
+        var result1 = queue.TryPeek(out var value1);
+        var result2 = queue.TryPeek(out var value2);
+
+        // Assert
+        result1.Should().BeTrue();
+        value1.Should().Be(1);
+        result2.Should().BeTrue();
+        value2.Should().Be(1);
+        queue.Should().HaveCount(3);
+    }
+
+    [Fact]
+    public void TryPeek_EmptyQueue_Test()
+    {
+        // Arrange
+        var queue = new Queue<int>();
+
+        // Act
+        var result = queue.TryPeek(out var value);
+
+        // Assert
+        result.Should().BeFalse();
+        value.Should().Be(0);
+        queue.Should().BeEmpty();
+    }
+
+    [Fact]
+    public void TryPeek_AfterDequeue_Test()
+    {
+        // Arrange
+        var queue = new Queue<int>();
+        queue.Enqueue(1);
+        queue.Enqueue(2);
+
+        // Act
+        queue.TryDequeue(out _);
+        var result = queue.TryPeek(out var value);
+
+        // Assert
+        result.Should().BeTrue();
+        value.Should().Be(2);
+        queue.Should().HaveCount(1);
+    }
+}

PolyShim/NetCore20/Queue.cs

@@ -0,0 +1,41 @@
+#if (NETCOREAPP && !NETCOREAPP2_0_OR_GREATER) || (NETFRAMEWORK) || (NETSTANDARD && !NETSTANDARD2_1_OR_GREATER)
+#nullable enable
+// ReSharper disable RedundantUsingDirective
+// ReSharper disable CheckNamespace
+// ReSharper disable InconsistentNaming
+// ReSharper disable PartialTypeWithSinglePart
+
+using System.Collections.Generic;
+
+internal static partial class PolyfillExtensions
+{
+    extension<T>(Queue<T> queue)
+    {
+        // https://learn.microsoft.com/dotnet/api/system.collections.generic.queue-1.trydequeue
+        public bool TryDequeue(out T? result)
+        {
+            if (queue.Count > 0)
+            {
+                result = queue.Dequeue();
+                return true;
+            }
+
+            result = default;
+            return false;
+        }
+
+        // https://learn.microsoft.com/dotnet/api/system.collections.generic.queue-1.trypeek
+        public bool TryPeek(out T? result)
+        {
+            if (queue.Count > 0)
+            {
+                result = queue.Peek();
+                return true;
+            }
+
+            result = default;
+            return false;
+        }
+    }
+}
+#endif

PolyShim/Signatures.md

@@ -1,8 +1,8 @@
 # Signatures
 
-- **Total:** 226
+- **Total:** 228
 - **Types:** 62
-- **Members:** 164
+- **Members:** 166
 
 ___
 
@@ -186,6 +186,9 @@ ___
 - `Process`
   - [`Task WaitForExitAsync(CancellationToken)`](https://learn.microsoft.com/dotnet/api/system.diagnostics.process.waitforexitasync) <sup><sub>.NET 5.0</sub></sup>
   - [`void Kill(bool)`](https://learn.microsoft.com/dotnet/api/system.diagnostics.process.kill#system-diagnostics-process-kill(system-boolean)) <sup><sub>.NET Core 3.0</sub></sup>
+- `Queue<T>`
+  - [`bool TryDequeue(out T?)`](https://learn.microsoft.com/dotnet/api/system.collections.generic.queue-1.trydequeue) <sup><sub>.NET Core 2.0</sub></sup>
+  - [`bool TryPeek(out T?)`](https://learn.microsoft.com/dotnet/api/system.collections.generic.queue-1.trypeek) <sup><sub>.NET Core 2.0</sub></sup>
 - `Random`
   - [`Random Shared`](https://learn.microsoft.com/dotnet/api/system.random.shared) <sup><sub>.NET 6.0</sub></sup>
   - [`void NextBytes(Span<byte>)`](https://learn.microsoft.com/dotnet/api/system.random.nextbytes#system-random-nextbytes(system-span((system-byte)))) <sup><sub>.NET Core 2.1</sub></sup>