From 2fbfd572a8da936b7e1f4fece1fe65833c9d1208 Mon Sep 17 00:00:00 2001
From: Stephen Leitnick <sleitnick@gmail.com>
Date: Sun, 25 Nov 2018 01:39:23 -0500
Subject: [PATCH] Added FastRemoveFirstValue function

---
 .../Aero/Shared/TableUtil.modulescript.lua    | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/src/ReplicatedStorage/Aero/Shared/TableUtil.modulescript.lua b/src/ReplicatedStorage/Aero/Shared/TableUtil.modulescript.lua
index 79e4ad6..0f65f1f 100644
--- a/src/ReplicatedStorage/Aero/Shared/TableUtil.modulescript.lua
+++ b/src/ReplicatedStorage/Aero/Shared/TableUtil.modulescript.lua
@@ -8,6 +8,7 @@
 	TableUtil.Sync(Table tbl, Table templateTbl)
 	TableUtil.Print(Table tbl, String label, Boolean deepPrint)
 	TableUtil.FastRemove(Table tbl, Number index)
+	TableUtil.FastRemoveFirstValue(Table tbl, Variant value)
 	TableUtil.Map(Table tbl, Function callback)
 	TableUtil.Filter(Table tbl, Function callback)
 	TableUtil.Reduce(Table tbl, Function callback [, Number initialValue])
@@ -61,6 +62,20 @@
 			print(table.concat(tbl, " "))  -- > hello this is a test
 
 
+		FastRemoveFirstValue:
+
+			Calls FastRemove on the first index that holds the given value.
+
+			local tbl = {"abc", "hello", "hi", "goodbye", "hello", "hey"}
+			local removed, atIndex = TableUtil.FastRemoveFirstValue(tbl, "hello")
+			if (removed) then
+				print("Removed at index " .. atIndex)
+				print(table.concat(tbl, " "))  -- > abc hi goodbye hello hey
+			else
+				print("Did not find value")
+			end
+
+		
 		Map:
 
 			This allows you to construct a new table by calling the given function
@@ -354,9 +369,20 @@ local function DecodeJSON(str)
 end
 
 
+local function FastRemoveFirstValue(t, v)
+	local index = IndexOf(t, v)
+	if (index) then
+		FastRemove(t, index)
+		return true, index
+	end
+	return false, nil
+end
+
+
 TableUtil.Copy = CopyTable
 TableUtil.Sync = Sync
 TableUtil.FastRemove = FastRemove
+TableUtil.FastRemoveFirstValue = FastRemoveFirstValue
 TableUtil.Print = Print
 TableUtil.Map = Map
 TableUtil.Filter = Filter