Math

ฟังก์ชันคณิตศาสตร์และ utility สำหรับจัดรูปแบบตัวเลข ที่ใช้ได้ทั้ง Client และ Server ผ่าน `ESX.Math.*`

Math (ESX.Math.*)

หน้านี้รวบรวมฟังก์ชันอรรถประโยชน์ใน namespace ESX.Math.*

ใช้ได้ทั้ง Client-side และ Server-side

เหมาะกับงานปัดเศษตัวเลข และจัดรูปแบบตัวเลขสำหรับแสดงผล

ก่อนเริ่ม (แนะนำ)

• ตั้งค่าการเรียกใช้ Framework ให้ถูกต้องตาม Framework Usage

ฟังก์ชันในหน้านี้เป็น pure utility เป็นหลัก เหมาะกับงาน format ก่อนส่งไป UI หรือ log

แนวทางที่แนะนำ

• แยก “ข้อมูลจริง” กับ “ข้อมูลเพื่อแสดงผล” ออกจากกัน

• ใช้ Round ก่อนแสดงผล ไม่แนะนำใช้กับตรรกะการเงินหลัก ๆ

• ใช้ GroupDigits กับค่าที่เป็น string เพื่อคุมรูปแบบให้แน่นอน

---

ESX.Math.Round

ปัดเศษตัวเลขตามจำนวนตำแหน่งทศนิยมที่กำหนด

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

ESX.Math.Round(value, numDecimalPlaces)

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

Name	Type	Description
value	number	ตัวเลขที่ต้องการปัดเศษ
numDecimalPlaces	number	(ไม่บังคับ) จำนวนตำแหน่งทศนิยม (ค่าเริ่มต้น: 0)

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

Type	Description
number	ตัวเลขหลังปัดเศษแล้ว

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

example.lua

print(ESX.Math.Round(3.14159))     -- 3
print(ESX.Math.Round(3.14159, 2))  -- 3.14
print(ESX.Math.Round(3.14159, 4))  -- 3.1416

การปัดเศษอาจมีผลกับค่าทศนิยมแบบ floating point ถ้าคุณทำงานด้านการเงิน แนะนำให้คำนวณด้วยหน่วยย่อย (เช่น cents) แล้วค่อย format ตอนแสดงผล

---

ESX.Math.GroupDigits

จัดรูปแบบตัวเลขให้มี comma คั่นหลักพัน เพื่อให้อ่านง่าย

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

ESX.Math.GroupDigits(value)

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

Name	Type	Description
value	string	ตัวเลขในรูปแบบ string

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

Type	Description
string	string ที่จัดรูปแบบแล้ว

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

example.lua

print(ESX.Math.GroupDigits('1000000'))   -- "1,000,000"
print(ESX.Math.GroupDigits('50000'))     -- "50,000"

หากต้องการ format ตัวเลขที่เป็น number ให้แปลงเป็น string ก่อน ตัวอย่าง: ESX.Math.GroupDigits(tostring(1000000))

ตัวอย่างเพิ่มเติม (ขยายดู)

example.lua

local money = 1500000
local text = ESX.Math.GroupDigits(tostring(money))
print('$' .. text) -- "$1,500,000"

---

ESX.Math.Trim

ตัดช่องว่างด้านหน้าและด้านหลังออกจาก string

ฟังก์ชันนี้อยู่ใต้ ESX.Math.* เพื่อรองรับโค้ดเก่า (backwards compatibility)

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

ESX.Math.Trim(value)

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

Name	Type	Description
value	string	string ที่ต้องการ trim

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

Type	Description
string	string หลัง trim หรือ nil หาก input เป็น nil

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

example.lua

print(ESX.Math.Trim('  hello world  '))  -- "hello world"

หากส่งค่า nil เข้ามา ฟังก์ชันจะคืนค่า nil เหมาะกับเคสที่รับ input ที่อาจว่างจากหลายแหล่ง

---

ถัดไปควรอ่านอะไร

• ต้องการ utility ทั่วไปใน ESX.* ให้ดู Common

• ต้องการฟังก์ชัน string เพิ่มเติม ให้ดู String