Table

ฟังก์ชันจัดการตารางที่ใช้ได้ทั้ง Client และ Server ผ่าน ESX.Table.*

ฟังก์ชัน Table (ESX.Table.*)

หน้านี้รวบรวมฟังก์ชันอรรถประโยชน์สำหรับจัดการตาราง (table) ในภาษา Lua

เรียกใช้งานผ่าน ESX.Table.* และใช้ได้ทั้งฝั่ง Client และ Server

ฟังก์ชันในหน้านี้สามารถใช้งานได้ทั้ง Client และ Server

ข้อควรรู้ก่อนใช้งาน

• หลายฟังก์ชันในหน้านี้ทำงานกับ "ตารางแบบ Array" (index เรียง 1..n)

• ฟังก์ชันส่วนใหญ่จะ “คืนตารางใหม่” และไม่แก้ไขตารางต้นฉบับ

• หากเป็นตารางแบบ key/value (เช่น {name = 'alice'}) ให้เลือกฟังก์ชันให้เหมาะสม

---

ESX.Table.Clone

สร้างสำเนาแบบ deep copy ของตาราง พร้อมคง metatable เดิมไว้

รูปแบบการใช้งาน (Syntax)

ESX.Table.Clone(tbl)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	ตารางที่ต้องการทำสำเนา

ค่าที่ส่งคืน (Returns)

Type	Description
table	ตารางสำเนาแบบ deep copy

ตัวอย่างการใช้งาน (Example)

local original = { a = 1, b = { c = 2 } }
local copy = ESX.Table.Clone(original)
copy.b.c = 99
print(original.b.c) -- 2 (unchanged)

---

ESX.Table.Concat

รวม Array 2 ชุดเข้าด้วยกัน แล้วคืนค่าเป็น Array ใหม่ (ไม่แก้ไขของเดิม)

รูปแบบการใช้งาน (Syntax)

ESX.Table.Concat(tbl1, tbl2)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl1	table	Array ชุดแรก
tbl2	table	Array ชุดสอง

ค่าที่ส่งคืน (Returns)

Type	Description
table	Array ที่ถูกรวมแล้ว

ตัวอย่างการใช้งาน (Example)

local a = { 1, 2, 3 }
local b = { 4, 5, 6 }
local c = ESX.Table.Concat(a, b)
-- c = { 1, 2, 3, 4, 5, 6 }

---

ESX.Table.Filter

กรองสมาชิกใน Array ด้วย callback และคืนค่าเฉพาะรายการที่ callback คืน true

รูปแบบการใช้งาน (Syntax)

ESX.Table.Filter(tbl, cb)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการกรอง
cb	function	ฟังก์ชันทดสอบ function(element) → boolean

ค่าที่ส่งคืน (Returns)

Type	Description
table	Array ใหม่ที่ผ่านการกรอง

ตัวอย่างการใช้งาน (Example)

local numbers = { 1, 2, 3, 4, 5, 6 }
local evens = ESX.Table.Filter(numbers, function(n) return n % 2 == 0 end)
-- evens = { 2, 4, 6 }

---

ESX.Table.Find

คืนค่าสมาชิกตัวแรกใน Array ที่ผ่านเงื่อนไขของ callback

รูปแบบการใช้งาน (Syntax)

ESX.Table.Find(tbl, cb)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการค้นหา
cb	function	ฟังก์ชันทดสอบ function(element) → boolean

ค่าที่ส่งคืน (Returns)

Type	Description
any	สมาชิกตัวแรกที่พบ หรือ nil หากไม่พบ

ตัวอย่างการใช้งาน (Example)

local items = { { name = 'bread', count = 3 }, { name = 'water', count = 5 } }
local water = ESX.Table.Find(items, function(item) return item.name == 'water' end)
-- water = { name = 'water', count = 5 }

---

ESX.Table.FindIndex

คืนค่า “ตำแหน่ง (index)” ของสมาชิกตัวแรกที่ผ่านเงื่อนไขของ callback

รูปแบบการใช้งาน (Syntax)

ESX.Table.FindIndex(tbl, cb)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการค้นหา
cb	function	ฟังก์ชันทดสอบ function(element) → boolean

ค่าที่ส่งคืน (Returns)

Type	Description
number	index ที่พบ หรือ -1 หากไม่พบ

ตัวอย่างการใช้งาน (Example)

local items = { 'apple', 'banana', 'cherry' }
local idx = ESX.Table.FindIndex(items, function(v) return v == 'banana' end)
-- idx = 2

---

ESX.Table.IndexOf

ค้นหา index ของ "ค่าที่ระบุ" ที่พบครั้งแรกใน Array

รูปแบบการใช้งาน (Syntax)

ESX.Table.IndexOf(tbl, value)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการค้นหา
value	any	ค่าที่ต้องการค้นหา

ค่าที่ส่งคืน (Returns)

Type	Description
number	index ของค่า หรือ -1 หากไม่พบ

ตัวอย่างการใช้งาน (Example)

local fruits = { 'apple', 'banana', 'cherry' }
print(ESX.Table.IndexOf(fruits, 'banana')) -- 2
print(ESX.Table.IndexOf(fruits, 'grape'))  -- -1

---

ESX.Table.LastIndexOf

ค้นหา index ของ "ค่าที่ระบุ" ที่พบครั้งสุดท้ายใน Array

รูปแบบการใช้งาน (Syntax)

ESX.Table.LastIndexOf(tbl, value)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการค้นหา
value	any	ค่าที่ต้องการค้นหา

ค่าที่ส่งคืน (Returns)

Type	Description
number	index สุดท้ายของค่า หรือ -1 หากไม่พบ

ตัวอย่างการใช้งาน (Example)

local fruits = { 'apple', 'banana', 'cherry', 'banana' }
print(ESX.Table.LastIndexOf(fruits, 'banana')) -- 4
print(ESX.Table.LastIndexOf(fruits, 'grape'))  -- -1

---

ESX.Table.Map

แปลงสมาชิกทุกตัวใน Array ด้วย callback แล้วคืนค่าเป็น Array ผลลัพธ์ใหม่

รูปแบบการใช้งาน (Syntax)

ESX.Table.Map(tbl, cb)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการแปลง
cb	function	ฟังก์ชันแปลงค่า function(element, index) → new value

ค่าที่ส่งคืน (Returns)

Type	Description
table	Array ผลลัพธ์หลังแปลงค่า

ตัวอย่างการใช้งาน (Example)

local numbers = { 1, 2, 3 }
local doubled = ESX.Table.Map(numbers, function(n) return n * 2 end)
-- doubled = { 2, 4, 6 }

---

ESX.Table.Reverse

คืนค่าเป็น Array ใหม่ โดยกลับลำดับสมาชิกจากหลังไปหน้า

รูปแบบการใช้งาน (Syntax)

ESX.Table.Reverse(tbl)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการกลับลำดับ

ค่าที่ส่งคืน (Returns)

Type	Description
table	Array ใหม่ที่กลับลำดับแล้ว

ตัวอย่างการใช้งาน (Example)

local reversed = ESX.Table.Reverse({ 1, 2, 3 })
-- reversed = { 3, 2, 1 }

---

ESX.Table.Set

แปลง Array ให้เป็น "เซ็ต" ในรูปแบบ {[value] = true} เพื่อใช้เช็คสมาชิกได้เร็วขึ้น

รูปแบบการใช้งาน (Syntax)

ESX.Table.Set(tbl)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการแปลงเป็นเซ็ต

ค่าที่ส่งคืน (Returns)

Type	Description
table	ตารางแบบเซ็ต {[value] = true} สำหรับทุกสมาชิก

ตัวอย่างการใช้งาน (Example)

local fruits = { 'apple', 'banana', 'cherry' }
local fruitSet = ESX.Table.Set(fruits)
print(fruitSet['banana']) -- true
print(fruitSet['grape'])  -- nil

---

ESX.Table.SizeOf

นับจำนวน entry ทั้งหมดในตาราง (รวม key ที่ไม่เรียงลำดับแบบ Array)

รูปแบบการใช้งาน (Syntax)

ESX.Table.SizeOf(tbl)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	ตารางที่ต้องการนับจำนวน entry

ค่าที่ส่งคืน (Returns)

Type	Description
number	จำนวน entry ทั้งหมด

ตัวอย่างการใช้งาน (Example)

local t = { a = 1, b = 2, c = 3 }
print(ESX.Table.SizeOf(t)) -- 3

---

ESX.Table.Sort

คืนค่าเป็น iterator สำหรับวนลูป key/value ของตาราง โดยเรียง key ตามลำดับ

สามารถส่งฟังก์ชัน order เพื่อกำหนดการเรียงแบบกำหนดเองได้

รูปแบบการใช้งาน (Syntax)

ESX.Table.Sort(tbl, order)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	ตารางที่ต้องการวนลูปแบบเรียงลำดับ
order	function	(ไม่บังคับ) ฟังก์ชันเรียง function(tbl, a, b) → boolean

ค่าที่ส่งคืน (Returns)

Type	Description
function	iterator ที่คืนค่า key, value ตามลำดับที่ถูกเรียงแล้ว

ตัวอย่างการใช้งาน (Example)

local scores = { alice = 100, bob = 85, charlie = 92 }

-- เรียงตามตัวอักษรของ key
for name, score in ESX.Table.Sort(scores) do
    print(name, score)
end

-- เรียงแบบกำหนดเอง (คะแนนมากไปน้อย)
for name, score in ESX.Table.Sort(scores, function(t, a, b) return t[a] > t[b] end) do
    print(name, score)
end

เหมาะกับตารางแบบ key/value เช่น {name = score} มากกว่าตารางแบบ Array

---

ESX.Table.Join

รวมสมาชิกใน Array ให้เป็น string เดียว โดยคั่นด้วยตัวคั่นที่ระบุ

รูปแบบการใช้งาน (Syntax)

ESX.Table.Join(tbl, sep)

พารามิเตอร์ (Parameters)

Name	Type	Description
tbl	table	Array ที่ต้องการนำมารวมเป็นข้อความ
sep	string	(ไม่บังคับ) ตัวคั่น (ค่าเริ่มต้น: ',')

ค่าที่ส่งคืน (Returns)

Type	Description
string	ข้อความหลังรวมแล้ว

ตัวอย่างการใช้งาน (Example)

local words = { 'hello', 'world' }
print(ESX.Table.Join(words, ' ')) -- "hello world"
print(ESX.Table.Join(words))      -- "hello,world"