الجداول

-- إنشاء جدول فارغ وتعيينه للمتحول "t"
local t = {}
print(t) -- {}

-- إنشاء مصفوفة بثلاث عناصر
local testArray = {"سلسلة نصية", 3.14159, true}
print(testArray)

-- إنشاء مصفوفة بثلاث عناصر
local testArray = {"سلسلة نصية", 3.14159, true}

print(testArray[1]) -- سلسلة نصية
print(testArray[2]) -- 3.14159
print(testArray[3]) -- true

local testArray = {"سلسلة نصية", 3.14159, true}

testArray[2] = 12345
testArray[4] = "سلسلة نصية جديدة"

print(testArray[2]) -- 12345
print(testArray[4]) -- سلسلة نصية جديدة

local testArray = {"سلسلة نصية", 3.14159, true, "سلسلة نصية جديدة"}

-- حلقة باستخدام التكرار العام
for index, value in testArray do
	print(index, value)
end

-- التكرار باستخدام مشغل طول المصفوفة (#)
for index = 1, #testArray do
	print(index, testArray[index])
end

local testArray = {"سلسلة نصية", 3.14159}

table.insert(testArray, "سلسلة نصية جديدة")
testArray[#testArray+1] = "سلسلة نصية جديدة أخرى"

print(testArray[3]) -- سلسلة نصية جديدة
print(testArray[4]) -- سلسلة نصية جديدة أخرى

local testArray = {"العنصر الأول", "العنصر التالي"}

table.insert(testArray, 2, "العنصر الجديد #2")

print(testArray[1]) -- العنصر الأول
print(testArray[2]) -- العنصر الجديد #2
print(testArray[3]) -- العنصر التالي

local testArray = {"العنصر الأول", "العنصر التالي", "العنصر الأخير"}

table.remove(testArray, 2)

print(testArray[1]) -- العنصر الأول
print(testArray[2]) -- العنصر الأخير

local testDictionary = {
	fruitName = "ليمون",
	fruitColor = "أصفر",
	sour = true
}

local part = Instance.new("Part")

local testDictionary = {
	partType = "كتلة",
	[part] = true
}

local part = Instance.new("Part")

local testDictionary = {
	partType = "كتلة",
	[part] = true
}
-- تضمين علامات الاقتباس للمفاتيح النصية
print(testDictionary["partType"]) -- كتلة
-- أو استخدم . للفهرسة دون المسافات للمفاتيح النصية
print(testDictionary.partType) -- كتلة
-- تجاهل علامات الاقتباس للمفاتيح غير النصية
print(testDictionary[part]) -- true

local testDictionary = {
	fruitName = "ليمون",
	sour = true
}

-- تغيير قيمة المفاتيح الموجودة
testDictionary["fruitName"] = "كرز"
testDictionary.sour = false

-- إدراج زوج مفتاح-قيمة جديد
testDictionary.fruitCount = 10

print(testDictionary.fruitName) -- كرز
print(testDictionary.sour) -- false
print(testDictionary.fruitCount) -- 10

local testDictionary = {
	fruitName = "ليمون",
	fruitColor = "أصفر",
	sour = true
}

for key, value in testDictionary do
	print(key, value)
end

--[[ الناتج الناتج:
fruitName ليمون
sour true
fruitColor أصفر
]]

local testDictionary = {
	fruitName = "ليمون",
	fruitColor = "أصفر",
	sour = true
}

testDictionary.sour = nil

for key, value in testDictionary do
	print(key, value)
end
--[[ الناتج الناتج:
fruitName ليمون
fruitColor أصفر
]]

local originalArray = {10, 20}

local arrayReference = originalArray

print("الأصلي:", originalArray[1], originalArray[2])
print("المرجع:", arrayReference[1], arrayReference[2])

-- تغيير القيم في المصفوفة الأصلية
originalArray[1] = 1000
originalArray[2] = 2000

print("المرجع:", arrayReference[1], arrayReference[2])

--[[ الناتج الناتج:
الأصلي: 10 20
المرجع: 10 20
المرجع: 1000 2000
]]

local original = {
	key = "value",
	engine = "Roblox",
	playerID = 505306092
}

local clone = table.clone(original)

-- الدالة المستخدمة للنسخ العميق لجدول
local function deepClone(original)
	-- تعريف الجدول الجديد للنسخة
	local clone = table.clone(original) 

	-- حلقة عبر الجدول الأصلي للتحقق من قيم الجداول
	-- إذا تم العثور على جدول كقيمة، قم بنسخه بشكل عميق إلى المفتاح (الفهرس)
	for key, value in original do
		if type(value) == "table" then
			clone[key] = deepClone(value)
		end
	end

	-- إرجاع النسخة النهائية من الجدول المنسوخ بشكل عميق
	return clone
end

local original = {
	key = "value",
	playerInfo = {
		playerID = 505306092,
		playerName = "PlayerName"
	},
	otherInfo = {
		{
			{1, 3, 5, 7, 9}
		}
	}
}

local clone = deepClone(original)

local target = {
	key = "value",
	engine = "Roblox",
	playerID = 505306092
}

table.freeze(target)
target.playerID = 1 --> محاولة تعديل جدول للقراءة فقط

local function deepFreeze(target)
	-- تجميد الجدول بشكل سطحي
	table.freeze(target)

	-- تحقق من كل مفتاح في الجدول وجمده إذا كان جدولًا
	for _, value in target do
		-- تأكد من أن القيمة غير مجمدة؛ إذا كانت كذلك بالفعل، سيحدث خطأ
		if type(value) == "table" and table.isfrozen(value) == false then
			deepFreeze(value)
		end
	end
end

local target = {
	key = "value",
	playerInfo = {
		playerID = 505306092,
		playerName = "PlayerName"
	},
	otherInfo = {
		{
			{1, 3, 5, 7, 9}
		}
	}
}

deepFreeze(target)
target.playerInfo.playerID = 1 --> محاولة تعديل جدول للقراءة فقط