التكرار على الجداول

لقد قمت بالتكرار (loop) على جداول Lua عدة مرات من قبل — تحافظ Luau على نفس التكرارات تمامًا وتضيف أنواعًا (types) إلى متغَيّرات التكرار. بالنسبة لـ arrays، يتنقل ipairs عبر العناصر بالترتيب، من الفهرس 1 إلى #t، ويمكنك توضيح النوع لكل من المتغيرين:

local temps: {number} = {18, 21, 19}
for day: number, temp: number in ipairs(temps) do
    print(`Day {day}: {temp}`)
end

تذكر أن ipairs يتوقف عند أول فهرس مفقود — أي وجود ثغرة nil في المنتصف ينهي التكرار مبكرًا. نادراً ما تكون هذه مشكلة مع المصفوفات المنظمة جيدًا، ولكن من المفيد معرفتها.

بالنسبة لـ maps، استخدم pairs، الذي يزور كل زوج من المفاتيح والقيم — بما في ذلك المفاتيح من نوع string. في القاموس {[string]: number}، تكون متغَيّرات التكرار بطبيعة الحال string و number:

local ages: {[string]: number} = {Alice = 30, Bob = 25}
for name: string, age: number in pairs(ages) do
    print(`{name} is {age}`)
end

تحذير هام واحد: يزور pairs مفاتيح جزء التجزئة (hash-part) في ترتيب غير مضمون — يمكن أن يختلف بين مرات التشغيل. عندما تحتاج إلى مخرجات محددة ودقيقة (تقارير مرتبة، اختبارات)، قم بتجميع المفاتيح في array، واستخدم table.sort عليها، ثم قم بالتكرار عبر المفاتيح المرتبة باستخدام ipairs والوصول إلى عناصر الخريطة بواسطة الفهرس.