نمط Enum في Luau

البرامج مليئة بقيم مأخوذة من مجموعة صغيرة وثابتة: يكون الطلب قيد الانتظار أو مشحونًا أو تم تسليمه؛ ويكون اللاعب مواجهًا للأعلى أو للأسفل أو لليسار أو لليمين. تحتوي العديد من اللغات على كلمة مفتاحية enum لهذا الغرض. لكن Luau لا تحتوي عليها، ولا تحتاج إليها، لأن أداتين تملكهـما بالفعل تغطيان هذه المهمة.

النمط 1: جدول الثوابت. يربط جدول عادي الأسماء ذات المعنى بالقيم، مستبدلًا «الأرقام السحرية» المبعثرة في الشيفرة:

local Status = {
    Pending = 1,
    Active = 2,
    Done = 3,
}

print(Status.Active) -- 2

هذه قيمة حقيقية أثناء التشغيل: يمكنك قراءة Status.Active، ومقارنتها، وتمريرها، تمامًا مثل الجداول التي استخدمتها طوال الوقت.

النمط 2: اتحاد القيم الحرفية. نوع يتكوّن من قيم نصية مطابقة تمامًا، باستخدام الأنواع الحرفية التي تعرّفت إليها في فصل الاتحادات:

type Color = "red" | "green" | "blue"
local favorite: Color = "green" -- ✓
local oops: Color = "yellow"    -- ✗ type error

يوجد الاتحاد للمدقّق فقط، ومن دون أي تكلفة أثناء التشغيل، لكنه يضمن أن المتغير لا يمكنه الاحتفاظ بأي قيمة خارج المجموعة. يكمل النمطان أحدهما الآخر: يمنحك الجدول قيمًا أثناء التشغيل تحت اسم واحد؛ بينما يمنحك الاتحاد ضمانًا أثناء الترجمة. ولاحقًا في هذا الفصل ستتعرّف أيضًا إلى table.freeze، الذي يحمي جدول الثوابت من التعديل أثناء التشغيل.