التصريح عن الخرائط والوصول إليها

يبدو إعلان الـ map المحددة النوع مثل متعهدي الجداول (table constructors) الذين طالما كتبتهم — يقوم التوصيف (annotation) فقط بتحديد أنواعه للـ key والـ value:

local stock: {[string]: number} = {apples = 12, bananas = 5}

تستخدم القراءة والكتابة الفهرسة التي تعرفها. بالنسبة للمفاتيح التي تُعد معرّفات صالحة، يصل stock.apples و stock["apples"] إلى نفس الـ entry؛ كما أن الصيغة باستخدام أقواس المربع تتعامل أيضًا مع المفاتيح التي تحتوي على مسافات أو تلك المخزنة في متغيرات:

stock["cherries"] = 20   -- أضف إدخالاً جديداً
stock.bananas = 8        -- حدّث واحداً موجوداً
print(stock["apples"])  -- 12
print(stock["plums"])   -- nil — لم يُعيَّن قط

يراقب فاحص الأنواع (type checker) كل عملية كتابة: يميّز stock["apples"] = "many" بخطأ لأن "many" ليس number، واستخدام number كـ key يميّز بخطأ لأن المفاتيح يجب أن تكون من نوع string.

لـ حذف entry، قم بتعيين nil للـ key الخاص به — حيث يزيله stock["bananas"] = nil entirely، وتُعطي القراءات اللاحقة nil. لا توجد دالة حذف منفصلة؛ هذا هو أسلوب Lua القياسي، وهو لا يزال يفحص النوع في الـ map.