חתימות אינדקס

כבר פגשת טיפוסי מפה כמו {[string]: number} בפרק הטבלאות: חתימת אינדקס: כל מפתח מסוג מחרוזת ממפה לערך מספרי. הם שימושיים במיוחד כשהמפתחות אינם ידועים בזמן כתיבת הקוד: מונים, הגדרות, מטמונים, ניקוד — כל דבר שנבנה בזמן הריצה.

type Counts = {[string]: number}

local counts: Counts = {}
counts["potion"] = 3   -- מותר להשתמש בכל מחרוזת כמפתח
counts["sword"] = 1
counts["potion"] += 1  -- הערכים נבדקים כמספרים

חשוב לזכור שתי עובדות על זמן הריצה כשעובדים עם מפות. ראשית, קריאה של מפתח שמעולם לא הוגדר מחזירה nil: דפוס הספירה הקלאסי מטפל בכך בעזרת or, וממיר ערך "חסר" ל־0:

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

שנית, pairs() עובר על מפתחות של מפה בסדר שאינו מובטח: הפעלה של אותה תוכנית פעמיים יכולה לעבור על המפתחות בסדר שונה. בכל פעם שהפלט חייב להיות צפוי, אסוף את המפתחות במערך, מיין אותם באמצעות table.sort, ועבור במקום זאת על המערך הממוין:

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