Add support for `Dictionary<TKey, TValue>(TKey key, out TValue value)…

… Remove` (#93)

api_list.include.md

@@ -54,6 +54,11 @@
  * `Boolean TryFormat(Span<Char>, Int32&, ReadOnlySpan<Char>, IFormatProvider)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.decimal.tryformat)
 
 
+### Dictionary<TKey, TValue>
+
+ * `Boolean Remove(TKey, out TValue)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2.remove)
+
+
 ### Double
 
  * `Boolean TryFormat(Span<Char>, Int32&, ReadOnlySpan<Char>, IFormatProvider)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.double.tryformat)

readme.md

@@ -407,6 +407,11 @@ The class `PolyfillExtensions` includes the following extension methods:
  * `Boolean TryFormat(Span<Char>, Int32&, ReadOnlySpan<Char>, IFormatProvider)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.decimal.tryformat)
 
 
+### Dictionary<TKey, TValue>
+
+ * `Boolean Remove(TKey, out TValue)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2.remove)
+
+
 ### Double
 
  * `Boolean TryFormat(Span<Char>, Int32&, ReadOnlySpan<Char>, IFormatProvider)` [reference](https://learn.microsoft.com/en-us/dotnet/api/system.double.tryformat)

src/Polyfill/PolyfillExtensions_Dictionary.cs

@@ -0,0 +1,35 @@
+// <auto-generated />
+
+#pragma warning disable
+
+#if NETFRAMEWORK || NETSTANDARD2_0 || NETCOREAPP2X
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using Link = System.ComponentModel.DescriptionAttribute;
+
+static partial class PolyfillExtensions
+{
+    /// <summary>
+    /// Removes the value with the specified key from the <see cref="Dictionary{TKey,TValue}"/>, and copies the element
+    /// to the value parameter.
+    /// </summary>
+    /// <param name="target">A dictionary with keys of type TKey and values of type TValue.</param>
+    /// <param name="key">The key of the element to remove.</param>
+    /// <param name="value">The removed element.</param>
+    /// <typeparam name="TKey">The type of the keys in the dictionary.</typeparam>
+    /// <typeparam name="TValue">The type of the values in the dictionary.</typeparam>
+    /// <returns><code>true</code> if the element is successfully found and removed; otherwise, <code>false</code>.</returns>
+    /// <exception cref="ArgumentNullException"><paramref name="key"/> is <code>null</code>.</exception>
+    [Link("https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.dictionary-2.remove")]
+	public static bool Remove<TKey, TValue>(
+	    this Dictionary<TKey,TValue> target,
+	    TKey key,
+        [MaybeNullWhen(false)] out TValue value)
+    {
+        target.TryGetValue(key, out value);
+        return target.Remove(key);
+    }
+}
+#endif

src/Tests/PolyfillExtensionsTests_Dictionary.cs

@@ -0,0 +1,27 @@
+partial class PolyfillExtensionsTests
+{
+    [Test]
+    public void Dictionary_Remove()
+    {
+        var dictionary = new Dictionary<string, string?> { {"key", "value"} };
+
+        Assert.True(dictionary.Remove("key", out var value));
+        Assert.AreEqual("value", value);
+    }
+
+    [Test]
+    public void Dictionary_Remove_DoesntThrowOnMissingKey()
+    {
+        var dictionary = new Dictionary<string, string?>();
+
+        Assert.False(dictionary.Remove("non-existent key", out var value));
+        Assert.AreEqual(default, value);
+    }
+
+    [Test]
+    public void Dictionary_Remove_ThrowsOnNull()
+    {
+        var dictionary = new Dictionary<string, string>();
+        Assert.Throws<ArgumentNullException>(() => dictionary.Remove(null!, out _));
+    }
+}