refactor: Add JCS_Array

jcs090218 · jcs090218 · commit a6419b876f2d · 2025-06-09T06:05:01.000-07:00
diff --git a/Assets/JCSUnity/Scripts/GameObject/2D/JCS_OrderLayerObject.cs b/Assets/JCSUnity/Scripts/GameObject/2D/JCS_OrderLayerObject.cs
@@ -59,7 +59,7 @@ private void Awake()
             this.mSpriteRenderer = this.GetComponent<SpriteRenderer>();
 
             // clean up empty slot.
-            mSpriteRenderers = JCS_Util.RemoveEmptySlot<SpriteRenderer>(mSpriteRenderers);
+            mSpriteRenderers = JCS_Array.RemoveEmpty(mSpriteRenderers);
         }
 
         private void Start()
diff --git a/Assets/JCSUnity/Scripts/Handler/JCS_GamepadAnimationHandler.cs b/Assets/JCSUnity/Scripts/Handler/JCS_GamepadAnimationHandler.cs
@@ -51,7 +51,7 @@ public struct AnimationSet
 
         private void Start()
         {
-            this.animationSets = JCS_Util.RemoveEmptySlot(this.animationSets);
+            this.animationSets = JCS_Array.RemoveEmpty(this.animationSets);
 
             /* Register callback */
             {
diff --git a/Assets/JCSUnity/Scripts/Handler/JCS_GamepadSpriteHandler.cs b/Assets/JCSUnity/Scripts/Handler/JCS_GamepadSpriteHandler.cs
@@ -46,7 +46,7 @@ public struct SpriteSet
 
         private void Start()
         {
-            this.spriteSets = JCS_Util.RemoveEmptySlot(this.spriteSets);
+            this.spriteSets = JCS_Array.RemoveEmpty(this.spriteSets);
 
             /* Register callback */
             {
diff --git a/Assets/JCSUnity/Scripts/Input/JCS_ButtonSelectionGroup.cs b/Assets/JCSUnity/Scripts/Input/JCS_ButtonSelectionGroup.cs
@@ -69,7 +69,7 @@ public enum Direction
 
         private void Awake()
         {
-            this.mSelections = JCS_Util.RemoveEmptySlot(mSelections);
+            this.mSelections = JCS_Array.RemoveEmpty(mSelections);
 
             // let them know the grouper.
             foreach (JCS_ButtonSelection bs in mSelections)
@@ -223,7 +223,7 @@ public void SelectSelection(int selectionIndex, bool hoverCheck = false)
 
             this.mCurrentSelectIndex = selectionIndex;
 
-            this.mCurrentSelectIndex = JCS_Util.LoopIn(this.mCurrentSelectIndex, mSelections);
+            this.mCurrentSelectIndex = JCS_Array.LoopIn(this.mCurrentSelectIndex, mSelections);
 
             // active the new active selection.
             mSelections[mCurrentSelectIndex].Active = true;
diff --git a/Assets/JCSUnity/Scripts/Input/JCS_Input.cs b/Assets/JCSUnity/Scripts/Input/JCS_Input.cs
@@ -1073,7 +1073,7 @@ public static bool GetJoystickKeyByAction(
         /// </returns>
         public static bool IsJoystickConnected()
         {
-            return (!JCS_Util.IsArrayEmpty(Input.GetJoystickNames()));
+            return (!JCS_Array.IsEmpty(Input.GetJoystickNames()));
         }
 
         /// <summary>
diff --git a/Assets/JCSUnity/Scripts/Managers/3D/JCS_3DWalkActionManager.cs b/Assets/JCSUnity/Scripts/Managers/3D/JCS_3DWalkActionManager.cs
@@ -42,7 +42,7 @@ private void Awake()
         /// <param name="wa"> Target walk action you want to get manage. </param>
         public void AddWalkAction(JCS_3DWalkAction wa)
         {
-            mWalkActions = JCS_Util.RemoveEmptySlotIncludeMissing<JCS_3DWalkAction>(mWalkActions);
+            mWalkActions = JCS_Array.RemoveEmptyMissing(mWalkActions);
 
             mWalkActions.Add(wa);
         }
diff --git a/Assets/JCSUnity/Scripts/Managers/JCS_AppManager.cs b/Assets/JCSUnity/Scripts/Managers/JCS_AppManager.cs
@@ -207,7 +207,7 @@ public void AddLangText(JCS_LangText txt)
         /// </summary>
         public void RefreshLangTexts()
         {
-            this.mLangTexts = JCS_Util.RemoveEmptySlotIncludeMissing(this.mLangTexts);
+            this.mLangTexts = JCS_Array.RemoveEmptyMissing(this.mLangTexts);
 
             foreach (JCS_LangText txt in mLangTexts)
             {
diff --git a/Assets/JCSUnity/Scripts/Managers/JCS_PauseManager.cs b/Assets/JCSUnity/Scripts/Managers/JCS_PauseManager.cs
@@ -254,7 +254,7 @@ public void SetPause(bool act = true)
         /// </summary>
         private void RemoveNullRefInPauseActionList()
         {
-            mPauseActions = JCS_Util.RemoveEmptySlotIncludeMissing(mPauseActions);
+            mPauseActions = JCS_Array.RemoveEmptyMissing(mPauseActions);
         }
 
         /// <summary>
diff --git a/Assets/JCSUnity/Scripts/Managers/JCS_UIManager.cs b/Assets/JCSUnity/Scripts/Managers/JCS_UIManager.cs
@@ -195,7 +195,7 @@ private void Test()
         public void AddCanvas(JCS_Canvas canvas)
         {
             this.mCanvases.Add(canvas);
-            mCanvases = JCS_Util.RemoveEmptySlotIncludeMissing(mCanvases);
+            mCanvases = JCS_Array.RemoveEmptyMissing(mCanvases);
             mCanvases = SortCanvases_Insertion();
         }
         private List<JCS_Canvas> SortCanvases_Insertion()
diff --git a/Assets/JCSUnity/Scripts/Managers/Others/JCS_PortalManager.cs b/Assets/JCSUnity/Scripts/Managers/Others/JCS_PortalManager.cs
@@ -55,7 +55,7 @@ private void SetPlayerToPortalByLabel()
             if (!ps.RESET_POSITION_AT_START)
                 return;
 
-            mPortals = JCS_Util.RemoveEmptySlotIncludeMissing<JCS_2DPortal>(mPortals);
+            mPortals = JCS_Array.RemoveEmptyMissing(mPortals);
 
             foreach (JCS_2DPortal portal in mPortals)
             {
diff --git a/Assets/JCSUnity/Scripts/UI/LinkedObject/JCS_TransformLinkedObjectController.cs b/Assets/JCSUnity/Scripts/UI/LinkedObject/JCS_TransformLinkedObjectController.cs
@@ -187,7 +187,7 @@ public List<JCS_TransformLinkedObject> RemoveLinked(int n = 1, int startIndex =
 
         private void OrganizedLinked()
         {
-            mManagedList = JCS_Util.RemoveEmptySlotIncludeMissing(mManagedList);
+            mManagedList = JCS_Array.RemoveEmptyMissing(mManagedList);
 
             for (int index = 0; index < mManagedList.Count; ++index)
             {
diff --git a/Assets/JCSUnity/Scripts/UI/Page/JCS_PageIndicators.cs b/Assets/JCSUnity/Scripts/UI/Page/JCS_PageIndicators.cs
@@ -70,7 +70,7 @@ public void SetPage(int page)
         /// <param name="sprite"> The sprite to apply. </param>
         private void SetSprite(Sprite sprite)
         {
-            this.mIndicators = JCS_Util.RemoveEmptySlotIncludeMissing(this.mIndicators);
+            this.mIndicators = JCS_Array.RemoveEmptyMissing(this.mIndicators);
 
             foreach (Image ind in mIndicators)
             {
diff --git a/Assets/JCSUnity/Scripts/UI/Undo Redo/JCS_UndoRedoComponent.cs b/Assets/JCSUnity/Scripts/UI/Undo Redo/JCS_UndoRedoComponent.cs
@@ -210,7 +210,7 @@ public void Undo()
             {
                 case JCS_GUIType.INPUT_FIELD:
                     {
-                        JCS_InputFieldData ifd = JCS_Util.ListPopBack(mIF_Undo);
+                        JCS_InputFieldData ifd = JCS_Array.PopBack(mIF_Undo);
 
                         if (ifd == null)
                             break;
@@ -225,7 +225,7 @@ public void Undo()
 
                 case JCS_GUIType.DROP_DOWN:
                     {
-                        JCS_DropdownData ddd = JCS_Util.ListPopBack(mDD_Undo);
+                        JCS_DropdownData ddd = JCS_Array.PopBack(mDD_Undo);
 
                         if (ddd == null)
                             break;
@@ -240,7 +240,7 @@ public void Undo()
 
                 case JCS_GUIType.SLIDER:
                     {
-                        JCS_SliderData sd = JCS_Util.ListPopBack(mSli_Undo);
+                        JCS_SliderData sd = JCS_Array.PopBack(mSli_Undo);
 
                         if (sd == null)
                             break;
@@ -255,7 +255,7 @@ public void Undo()
 
                 case JCS_GUIType.SCROLL_BAR:
                     {
-                        JCS_ScrollbarData sbd = JCS_Util.ListPopBack(mSB_Undo);
+                        JCS_ScrollbarData sbd = JCS_Array.PopBack(mSB_Undo);
 
                         if (sbd == null)
                             break;
@@ -270,7 +270,7 @@ public void Undo()
 
                 case JCS_GUIType.TOGGLE:
                     {
-                        JCS_ToggleData td = JCS_Util.ListPopBack(mTog_Undo);
+                        JCS_ToggleData td = JCS_Array.PopBack(mTog_Undo);
 
                         if (td == null)
                             break;
@@ -311,7 +311,7 @@ public void Redo()
             {
                 case JCS_GUIType.INPUT_FIELD:
                     {
-                        JCS_InputFieldData ifd = JCS_Util.ListPopBack(mIF_Redo);
+                        JCS_InputFieldData ifd = JCS_Array.PopBack(mIF_Redo);
 
                         if (ifd == null)
                             break;
@@ -326,7 +326,7 @@ public void Redo()
 
                 case JCS_GUIType.DROP_DOWN:
                     {
-                        JCS_DropdownData ddd = JCS_Util.ListPopBack(mDD_Redo);
+                        JCS_DropdownData ddd = JCS_Array.PopBack(mDD_Redo);
 
                         if (ddd == null)
                             break;
@@ -341,7 +341,7 @@ public void Redo()
 
                 case JCS_GUIType.SLIDER:
                     {
-                        JCS_SliderData sd = JCS_Util.ListPopBack(mSli_Redo);
+                        JCS_SliderData sd = JCS_Array.PopBack(mSli_Redo);
 
                         if (sd == null)
                             break;
@@ -356,7 +356,7 @@ public void Redo()
 
                 case JCS_GUIType.SCROLL_BAR:
                     {
-                        JCS_ScrollbarData sbd = JCS_Util.ListPopBack(mSB_Redo);
+                        JCS_ScrollbarData sbd = JCS_Array.PopBack(mSB_Redo);
 
                         if (sbd == null)
                             break;
@@ -371,7 +371,7 @@ public void Redo()
 
                 case JCS_GUIType.TOGGLE:
                     {
-                        JCS_ToggleData td = JCS_Util.ListPopBack(mTog_Redo);
+                        JCS_ToggleData td = JCS_Array.PopBack(mTog_Redo);
 
                         if (td == null)
                             break;
diff --git a/Assets/JCSUnity/Scripts/UI/Undo Redo/JCS_UndoRedoSystem.cs b/Assets/JCSUnity/Scripts/UI/Undo Redo/JCS_UndoRedoSystem.cs
@@ -95,7 +95,7 @@ private void Test()
         /// </summary>
         public void UndoComponent()
         {
-            JCS_UndoRedoComponent undoComp = JCS_Util.ListPopBack(mUndoComp);
+            JCS_UndoRedoComponent undoComp = JCS_Array.PopBack(mUndoComp);
 
             if (undoComp == null)
                 return;
@@ -110,7 +110,7 @@ public void UndoComponent()
         /// </summary>
         public void RedoComponent()
         {
-            JCS_UndoRedoComponent redoComp = JCS_Util.ListPopBack(mRedoComp);
+            JCS_UndoRedoComponent redoComp = JCS_Array.PopBack(mRedoComp);
 
             if (redoComp == null)
                 return;
diff --git a/Assets/JCSUnity/Scripts/Util/JCS_Array.cs b/Assets/JCSUnity/Scripts/Util/JCS_Array.cs
diff --git a/Assets/JCSUnity/Scripts/Util/JCS_Array.cs.meta b/Assets/JCSUnity/Scripts/Util/JCS_Array.cs.meta
diff --git a/Assets/JCSUnity/Scripts/Util/JCS_Util.cs b/Assets/JCSUnity/Scripts/Util/JCS_Util.cs
diff --git a/Assets/_Project/Scripts/Others/FT_Utility.cs b/Assets/_Project/Scripts/Others/FT_Utility.cs
diff --git a/docs/ScriptReference/Util/JCS_Array.md b/docs/ScriptReference/Util/JCS_Array.md
diff --git a/docs/ScriptReference/Util/JCS_Util.md b/docs/ScriptReference/Util/JCS_Util.md

Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,7 @@ private void Awake()`
`59`	`59`	`this.mSpriteRenderer = this.GetComponent<SpriteRenderer>();`
`60`	`60`
`61`	`61`	`// clean up empty slot.`
`62`		`- mSpriteRenderers = JCS_Util.RemoveEmptySlot<SpriteRenderer>(mSpriteRenderers);`
	`62`	`+ mSpriteRenderers = JCS_Array.RemoveEmpty(mSpriteRenderers);`
`63`	`63`	`}`
`64`	`64`
`65`	`65`	`private void Start()`
Original file line number	Diff line number	Diff line change
`@@ -51,7 +51,7 @@ public struct AnimationSet`
`51`	`51`
`52`	`52`	`private void Start()`
`53`	`53`	`{`
`54`		`- this.animationSets = JCS_Util.RemoveEmptySlot(this.animationSets);`
	`54`	`+ this.animationSets = JCS_Array.RemoveEmpty(this.animationSets);`
`55`	`55`
`56`	`56`	`/* Register callback */`
`57`	`57`	`{`
Original file line number	Diff line number	Diff line change
`@@ -46,7 +46,7 @@ public struct SpriteSet`
`46`	`46`
`47`	`47`	`private void Start()`
`48`	`48`	`{`
`49`		`- this.spriteSets = JCS_Util.RemoveEmptySlot(this.spriteSets);`
	`49`	`+ this.spriteSets = JCS_Array.RemoveEmpty(this.spriteSets);`
`50`	`50`
`51`	`51`	`/* Register callback */`
`52`	`52`	`{`
Original file line number	Diff line number	Diff line change
`@@ -1073,7 +1073,7 @@ public static bool GetJoystickKeyByAction(`
`1073`	`1073`	`/// </returns>`
`1074`	`1074`	`public static bool IsJoystickConnected()`
`1075`	`1075`	`{`
`1076`		`- return (!JCS_Util.IsArrayEmpty(Input.GetJoystickNames()));`
	`1076`	`+ return (!JCS_Array.IsEmpty(Input.GetJoystickNames()));`
`1077`	`1077`	`}`
`1078`	`1078`
`1079`	`1079`	`/// <summary>`
Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,7 @@ private void Awake()`
`42`	`42`	`/// <param name="wa"> Target walk action you want to get manage. </param>`
`43`	`43`	`public void AddWalkAction(JCS_3DWalkAction wa)`
`44`	`44`	`{`
`45`		`- mWalkActions = JCS_Util.RemoveEmptySlotIncludeMissing<JCS_3DWalkAction>(mWalkActions);`
	`45`	`+ mWalkActions = JCS_Array.RemoveEmptyMissing(mWalkActions);`
`46`	`46`
`47`	`47`	`mWalkActions.Add(wa);`
`48`	`48`	`}`
Original file line number	Diff line number	Diff line change
`@@ -207,7 +207,7 @@ public void AddLangText(JCS_LangText txt)`
`207`	`207`	`/// </summary>`
`208`	`208`	`public void RefreshLangTexts()`
`209`	`209`	`{`
`210`		`- this.mLangTexts = JCS_Util.RemoveEmptySlotIncludeMissing(this.mLangTexts);`
	`210`	`+ this.mLangTexts = JCS_Array.RemoveEmptyMissing(this.mLangTexts);`
`211`	`211`
`212`	`212`	`foreach (JCS_LangText txt in mLangTexts)`
`213`	`213`	`{`
Original file line number	Diff line number	Diff line change
`@@ -254,7 +254,7 @@ public void SetPause(bool act = true)`
`254`	`254`	`/// </summary>`
`255`	`255`	`private void RemoveNullRefInPauseActionList()`
`256`	`256`	`{`
`257`		`- mPauseActions = JCS_Util.RemoveEmptySlotIncludeMissing(mPauseActions);`
	`257`	`+ mPauseActions = JCS_Array.RemoveEmptyMissing(mPauseActions);`
`258`	`258`	`}`
`259`	`259`
`260`	`260`	`/// <summary>`
Original file line number	Diff line number	Diff line change
`@@ -195,7 +195,7 @@ private void Test()`
`195`	`195`	`public void AddCanvas(JCS_Canvas canvas)`
`196`	`196`	`{`
`197`	`197`	`this.mCanvases.Add(canvas);`
`198`		`- mCanvases = JCS_Util.RemoveEmptySlotIncludeMissing(mCanvases);`
	`198`	`+ mCanvases = JCS_Array.RemoveEmptyMissing(mCanvases);`
`199`	`199`	`mCanvases = SortCanvases_Insertion();`
`200`	`200`	`}`
`201`	`201`	`private List<JCS_Canvas> SortCanvases_Insertion()`
Original file line number	Diff line number	Diff line change
`@@ -55,7 +55,7 @@ private void SetPlayerToPortalByLabel()`
`55`	`55`	`if (!ps.RESET_POSITION_AT_START)`
`56`	`56`	`return;`
`57`	`57`
`58`		`- mPortals = JCS_Util.RemoveEmptySlotIncludeMissing<JCS_2DPortal>(mPortals);`
	`58`	`+ mPortals = JCS_Array.RemoveEmptyMissing(mPortals);`
`59`	`59`
`60`	`60`	`foreach (JCS_2DPortal portal in mPortals)`
`61`	`61`	`{`