توقيعات الفهارس (Index Signatures)

لقد صادفت أنواع الخرائط مثل {[string]: number} في فصل الجداول: توقيع فهرس: يربط مفتاح any من نوع string بقيمة من نوع number. وتبرز فائدتها عندما لا تكون المفاتيح معروفة أثناء كتابة الشيفرة: العدادات، والإعدادات، وذاكرات التخزين المؤقت، والنتائج: أي شيء يُبنى أثناء وقت التشغيل.

type Counts = {[string]: number}

local counts: Counts = {}
counts["potion"] = 3   -- يُسمح بأي مفتاح نصي
counts["sword"] = 1
counts["potion"] += 1  -- يتم التحقق من القيم كأرقام

هناك حقيقتان أثناء وقت التشغيل مهمتان عند العمل مع الخرائط. أولًا، تؤدي قراءة مفتاح لم يسبق تعيينه إلى إرجاع nil: يعالج نمط العدّ الكلاسيكي ذلك باستخدام or، إذ يحوّل القيمة "missing" إلى 0:

counts[item] = (counts[item] or 0) + 1

ثانيًا، تكرّر pairs() مفاتيح الخريطة بترتيب غير مضمون: قد تؤدي إعادة تشغيل البرنامج نفسه مرتين إلى زيارة المفاتيح بطرق مختلفة. عندما يجب أن يكون الناتج قابلًا للتنبؤ، اجمع المفاتيح في array، ثم نفّذ table.sort عليها، وكرّر على array المرتّبة بدلًا من ذلك:

local keys: {string} = {}
for key in pairs(counts) do
    table.insert(keys, key)
end
table.sort(keys)
for _, key in ipairs(keys) do
    print(`{key}: {counts[key]}`)
end