Merge branch 'master' of https://github.com/StevenH237/CSharp.Nixill

CSharp.Nixill/src/Utils/Extensions/CollectionExtensions.cs

@@ -5,6 +5,37 @@ namespace Nixill.Utils.Extensions;
 /// </summary>
 public static class CollectionExtensions
 {
+  /// <summary>
+  ///   Adds all of the given entries to the dictionary. Key collisions
+  ///   are resolved in favor of existing entries.
+  /// </summary>
+  /// <typeparam name="K">The type of keys in the dictionary.</typeparam>
+  /// <typeparam name="V">
+  ///   The type of values in the dictionary.
+  /// </typeparam>
+  /// <param name="dictionary">The dictionary.</param>
+  /// <param name="items">The items to add.</param>
+  public static void AddMissing<K, V>(this IDictionary<K, V> dictionary, IEnumerable<(K Key, V Value)> items)
+    => dictionary.AddMissing(items.Select(i => new KeyValuePair<K, V>(i.Key, i.Value)));
+
+  /// <summary>
+  ///   Adds all of the given entries to the dictionary. Key collisions
+  ///   are resolved in favor of existing entries.
+  /// </summary>
+  /// <typeparam name="K">The type of keys in the dictionary.</typeparam>
+  /// <typeparam name="V">
+  ///   The type of values in the dictionary.
+  /// </typeparam>
+  /// <param name="dictionary">The dictionary.</param>
+  /// <param name="items">The items to add.</param>
+  public static void AddMissing<K, V>(this IDictionary<K, V> dictionary, IEnumerable<KeyValuePair<K, V>> items)
+  {
+    foreach (var item in items)
+    {
+      dictionary.GetOrSet(item.Key, item.Value);
+    }
+  }
+
   /// <summary>
   ///   Returns a value associated with a given key from the dictionary,
   ///   or saves a new association and returns it if the given key isn't
@@ -75,6 +106,37 @@ public static T Pop<T>(this IList<T> list)
     return value;
   }
 
+  /// <summary>
+  ///   Sets all of the given entries in the dictionary. Key collisions
+  ///   are resolved in favor of new entries.
+  /// </summary>
+  /// <typeparam name="K">The type of keys in the dictionary.</typeparam>
+  /// <typeparam name="V">
+  ///   The type of values in the dictionary.
+  /// </typeparam>
+  /// <param name="dictionary">The dictionary.</param>
+  /// <param name="items">The items to add.</param>
+  public static void SetAll<K, V>(this IDictionary<K, V> dictionary, IEnumerable<(K Key, V Value)> items)
+    => dictionary.SetAll(items.Select(i => new KeyValuePair<K, V>(i.Key, i.Value)));
+
+  /// <summary>
+  ///   Sets all of the given entries in the dictionary. Key collisions
+  ///   are resolved in favor of new entries.
+  /// </summary>
+  /// <typeparam name="K">The type of keys in the dictionary.</typeparam>
+  /// <typeparam name="V">
+  ///   The type of values in the dictionary.
+  /// </typeparam>
+  /// <param name="dictionary">The dictionary.</param>
+  /// <param name="items">The items to add.</param>
+  public static void SetAll<K, V>(this IDictionary<K, V> dictionary, IEnumerable<KeyValuePair<K, V>> items)
+  {
+    foreach (var item in items)
+    {
+      dictionary[item.Key] = item.Value;
+    }
+  }
+
   /// <summary>
   ///   Converts a sequence of <c>IGrouping&lt;K, V&gt;</c>s to a single
   ///   dictionary of type <c>IDictionary&lt;K, IEnumerable&lt;V&gt;&gt;</c>.