توضيحات أشكال الجداول المضمنة

في Lua، كنت تستخدم الـ tables كـ records لفترة طويلة: local user = {name = "Ana", age = 20}. لا شيء يمنعك من ارتكاب خطأ إملائي في اسم أحد الـ fields، أو نسيان أحدهما، أو تخزين string مكان number — ولن تكتشف ذلك إلا عند تشغيل الكود.

تتيح لك Luau وصف الـ shape الخاص بـ table كهذا مباشرة في التصريح، من خلال إدراج كل field ونوعه بين أقواس مجعدة:

local user: {name: string, age: number} = {
    name = "Ana",
    age = 20,
}

قارن هذا بأشكال الـ table أنواع التي تعرفها بالفعل: {number} يصف array، و {[string]: number} يصف map بأي مفاتيح من نوع string. الـ shape أكثر دقة — فهو يحدد كل field باسمه بشكل فردي ويعطي كل field نوعه الخاص.

بمجرد التصريح عن الـ shape، يتحقق فاحص أنواع الـ (type checker) من الـ table بناءً عليه أثناء التحرير. يتم التنبيه على أي field مفقود أو نوع قيمة خاطئ قبل تشغيل الكود:

local user: {name: string, age: number} = {
    name = "Ana",
    age = "twenty", -- ✗ خطأ نوع: string ليس number
}

كما هو الحال دائمًا، لا يضيف الـ annotation أي سلوك أثناء وقت التشغيل (runtime) — فالـ table هو مجرد Lua table عادي. تعتبر الـ inline shapes مثالية للبنى الفريدة التي لا تخطط لإعادة استخدامها؛ وفي الدرس القادم ستتعلم كيفية إعطاء الـ shapes اسمًا.