تعدادات النصوص كاتحادات (Unions)

تجعل الأرقام السجلات غامضة: رؤية 2 تخبرك بالقليل، بينما رؤية "down" تخبرك بكل شيء. للحصول على تعدادات (enums) قابلة للقراءة، تُعد أنواع الاتحاد النصي (literal union types) في Luau هي الأداة المناسبة — وهي نوع تكون أعضاؤه نصوصًا دقيقة:

type Direction = "up" | "down" | "left" | "right"

local facing: Direction = "up"    -- ✓
local typo: Direction = "upp"     -- ✗ خطأ نوع أثناء التحرير

يمكن للمتغير المكتوب بـ Direction أن يحمل تلك النصوص الأربعة four ولا شيء غيرها. إذا أخطأت في كتابة أحدها، فسيكتشف الفاحص ذلك فورًا — ولن يصل الخطأ البرمجي إلى اللاعب أبدًا.

في وقت التشغيل (runtime)، تكون القيم نصوصًا العادية (plain strings). قم بطباعتها، أو ربطها، أو مقارنتها بـ == — كل ما تعرفه عن النصوص ينطبق عليها:

print(facing)            -- أعلى
print(`facing {facing}`) -- مواجه لأعلى

قارن بين النمطين اللذين لديك الآن: جدول الثوابت ينشئ قيمة واحدة في وقت التشغيل تحتوي على الأعضاء، بينما اتحاد النصوص لا ينشئ أي قيمة على الإطلاق — لا يوجد جدول Direction، بل مجرد قاعدة يفرضها الفاحص حول النصوص المناسبة. القيم الوصفية ذاتية التوثيق ذات التكلفة المنعدمة في وقت التشغيل تجعل اتحاد النصوص هو أسلوب التعداد المفضل في كود Luau.