feat(Util): Add more loop operations

Author: jcs090218

Assets/JCSUnity/Scripts/Util/JCS_Loop.cs

@@ -7,6 +7,7 @@
  *                   Copyright (c) 2025 by Shen, Jen-Chieh $
  */
 using System;
+using System.Collections.Generic;
 
 namespace JCSUnity
 {
@@ -21,17 +22,81 @@ public static class JCS_Loop
 
         /* Functions */
 
+        /// <summary>
+        /// Loop in range.
+        /// </summary>
+        /// <param name="start"> Start index. </param>
+        /// <param name="end"> End index. </param>
+        /// <param name="action"> Action to execute in range. </param>
+        public static void Range(int start, int end, Action<int> action)
+        {
+            for (int count = start; count < end; ++count)
+            {
+                if (action != null)
+                    action.Invoke(count);
+            }
+        }
+
         /// <summary>
         /// Loops a specific number of times.
         /// </summary>
         /// <param name="times"> Times to loop over. </param>
         /// <param name="action"> Action to execute each times. </param>
         public static void Times(int times, Action<int> action)
         {
-            for (int count = 0; count < times; ++count)
+            Range(0, times, action);
+        }
+
+        /// <summary>
+        /// Like `foreach` but with index.
+        /// </summary>
+        /// <typeparam name="T"> The type of the item. </typeparam>
+        /// <param name="coll"> The collection. </param>
+        /// <param name="action"> Action to execute. </param>
+        public static void ForEach<T>(ICollection<T> coll, Action<T> action)
+        {
+            ForEach(coll, (count, item) =>
             {
                 if (action != null)
-                    action.Invoke(count);
+                    action.Invoke(item);
+            });
+        }
+        public static void ForEach<T>(ICollection<T> coll, Action<int, T> action)
+        {
+            int count = 0;
+
+            foreach (T item in coll)
+            {
+                if (action != null)
+                    action.Invoke(count, item);
+
+                ++count;
+            }
+        }
+
+        /// <summary>
+        /// Loop through dictionary.
+        /// </summary>
+        /// <param name="dict"> The dictionary. </param>
+        /// <param name="action"> Action to execute. </param>
+        public static void ForEach<T, V>(IDictionary<T, V> dict, Action<KeyValuePair<T, V>> action)
+        {
+            ForEach(dict, (_, entry) =>
+            {
+                if (action != null)
+                    action.Invoke(entry);
+            });
+        }
+        public static void ForEach<T, V>(IDictionary<T, V> dict, Action<int, KeyValuePair<T, V>> action)
+        {
+            int count = 0;
+
+            foreach (KeyValuePair<T, V> entry in dict)
+            {
+                if (action != null)
+                    action.Invoke(count, entry);
+
+                ++count;
             }
         }
     }

docs/ScriptReference/Util/JCS_Loop.md

@@ -4,6 +4,8 @@ Loop operations.
 
 ## Functions
 
-| Name  | Description                       |
-|:------|:----------------------------------|
-| Times | Loops a specific number of times. |
+| Name    | Description                       |
+|:--------|:----------------------------------|
+| Range   | Loop in range.                    |
+| Times   | Loops a specific number of times. |
+| ForEach | Loop through collection.          |