Add ConcurrentQueue Clear (#246)

apiCount.include.md

@@ -1 +1 @@
-**API count: 401**
+**API count: 402**

api_list.include.md

@@ -32,6 +32,11 @@
  * `TValue GetOrAdd<TKey, TValue, TArg>(TKey, Func<TKey, TArg, TValue>, TArg) where TKey : notnull` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentdictionary-2.getoradd#system-collections-concurrent-concurrentdictionary-2-getoradd-1(-0-system-func((-0-0-1))-0))
 
 
+#### ConcurrentQueue<T>
+
+ * `void Clear<T>()` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentqueue-1.clear)
+
+
 #### DateOnly
 
  * `bool TryFormat(Span<char>, int, ReadOnlySpan<char>, IFormatProvider?)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.dateonly.tryformat)

readme.md

@@ -12,7 +12,7 @@ The package targets `netstandard2.0` and is designed to support the following ru
  * `net5.0`, `net6.0`, `net7.0`, `net8.0`, `net9.0`
 
 
-**API count: 401**<!-- singleLineInclude: apiCount. path: /apiCount.include.md -->
+**API count: 402**<!-- singleLineInclude: apiCount. path: /apiCount.include.md -->
 
 
 **See [Milestones](../../milestones?state=closed) for release notes.**
@@ -485,6 +485,11 @@ The class `Polyfill` includes the following extension methods:
  * `TValue GetOrAdd<TKey, TValue, TArg>(TKey, Func<TKey, TArg, TValue>, TArg) where TKey : notnull` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentdictionary-2.getoradd#system-collections-concurrent-concurrentdictionary-2-getoradd-1(-0-system-func((-0-0-1))-0))
 
 
+#### ConcurrentQueue<T>
+
+ * `void Clear<T>()` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentqueue-1.clear)
+
+
 #### DateOnly
 
  * `bool TryFormat(Span<char>, int, ReadOnlySpan<char>, IFormatProvider?)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.dateonly.tryformat)

src/Consume/Consume.cs

@@ -228,6 +228,12 @@ void ConcurrentBag_Methods()
         bag.Clear();
     }
 
+    void ConcurrentQueue_Methods()
+    {
+        var bag = new ConcurrentQueue<string>();
+        bag.Clear();
+    }
+
     void Dictionary_Methods()
     {
         var dictionary = new Dictionary<string, string?> { { "key", "value" } };

src/Polyfill/Polyfill_ConcurrentBag.cs

@@ -17,11 +17,6 @@ static partial class Polyfill
     [Link("https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentbag-1.clear")]
     public static void Clear<T>(this ConcurrentBag<T> target)
     {
-        if (target is null)
-        {
-            throw new ArgumentNullException(nameof(target));
-        }
-
         while (!target.IsEmpty)
         {
             target.TryTake(out _);

src/Polyfill/Polyfill_ConcurrentQueue.cs

@@ -0,0 +1,23 @@
+// <auto-generated />
+#pragma warning disable
+
+#if NETFRAMEWORK || NETSTANDARD2_0
+
+namespace Polyfills;
+
+using System;
+using System.Collections.Concurrent;
+using Link = System.ComponentModel.DescriptionAttribute;
+
+static partial class Polyfill
+{
+    /// <summary>
+    /// Removes all values from the <see cref="ConcurrentQueue{T}"/>.
+    /// </summary>
+    [Link("https://learn.microsoft.com/en-us/dotnet/api/system.collections.concurrent.concurrentqueue-1.clear")]
+    public static void Clear<T>(this ConcurrentQueue<T> target)
+    {
+        while (target.TryDequeue(out _));
+    }
+}
+#endif

src/Tests/PolyfillTests_ConcurrentQueue.cs

@@ -0,0 +1,11 @@
+partial class PolyfillTests
+{
+    [Test]
+    public void ConcurrentQueueClear()
+    {
+        var bag = new ConcurrentQueue<string>();
+        bag.Enqueue("Hello");
+        bag.Clear();
+        Assert.AreEqual(0, bag.Count);
+    }
+}