التعدادات الرقمية باستخدام الجداول
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy — الدرس 52 من 73.
دعنا نبني نمط الجدول الثابت (constant-table pattern) بشكل صحيح. اختر اسم جدول بأسلوب PascalCase، وامنح كل عضو برقم صريح، ومن تلك اللحظة فصاعدًا يتحدث الكود بالأسماء:
local UserRole = {
Admin = 1,
Editor = 2,
Viewer = 3,
}على عكس enum في TypeScript، لا يتم ترقيم أي شيء تلقائيًا — أنت تختار كل قيمة. البدء من 1 يناسب أعراف Lua تمامًا، ولكن أي مخطط سيعمل (رموز بأسلوب HTTP مثل 200 و 404 ممتازة أيضًا).
تتألق الأعضاء في المقارنات. يمكن لدالة تتلقى دورًا (role) أن تتفرع بناءً على الثوابت المnamed بدلاً من الأرقام الخالية:
local function checkPermissions(role: number)
if role == UserRole.Admin then
print("Full access granted")
elseif role == UserRole.Editor then
print("Edit access granted")
else
print("View access only")
end
endلاحظ أن المعلمة محددة بـ number — نمط الجدول وحده لا يقيد الأرقام المسموح بها. هذا الضمان هو بالضبط ما تضيفه اتحادات القيم الحرفية (literal unions) في الدرس القادم.
التحدي
سهلأنشئ table ثابتاً باسم UserRole يحتوي على three من الـ members:
Admin=1Editor=2Viewer=3
أنشئ function باسم checkPermissions تأخذ role: number وتطبع:
Full access grantedإذا كانت الـroleهيUserRole.AdminEdit access grantedإذا كانت الـroleهيUserRole.EditorView access onlyبخلاف ذلك
ثم، بالترتيب:
- اطبع
UserRole.Admin - اطبع
UserRole.Editor - اطبع
UserRole.Viewer - قم بـ
callلـcheckPermissions(UserRole.Admin) - قم بـ
callلـcheckPermissions(UserRole.Editor) - قم بـ
callلـcheckPermissions(UserRole.Viewer)
جرّب بنفسك
-- اكتب الكود هنا
-- 1) أنشئ جدول الثوابت UserRole (Admin=1, Editor=2, Viewer=3)
-- 2) اكتب checkPermissions(role: number) باستخدام if/elseif/else
-- 3) اطبع الأعضاء الثلاثة، ثم استدعِ الدالة لكل واحد
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس مقدمة إلى Luau
1البدء مع Luau
ما هي Luau؟لماذا نستخدم Luau؟أول كود لك بلغة Luauفحص الأنواع وأنماط الأخطاءملخص: مقدمة إلى Luau4العمل مع الدوال
تحديد أنواع المعاملات والقيم المرجعةتحديد أنواع الدوال المجهولةالدوال التي لا ترجع شيئاًالمعاملات الاختياريةالقيم الافتراضية للمعاملاتالدوال متغيرة المعاملاتتعريف أنواع الدوالملخص: الدوال محددة الأنواع7المشروع: مدير المهام مع أنواع البيانات
المشروع: هيكل المهامدالة لإضافة تفاصيل مهمة2الأنواع الأساسية
الأنواع الأساسية: num و str و boolالنوع 'any': مخرج الطوارئالنوع 'unknown'أنواع Nil والأنواع الاختياريةاستنتاج الأنواع في التطبيق العمليتوضيحات الأنواع الصريحةملخص: تدريبات على الأنواع الأساسية5الأسماء المستعارة، الأنواع المشتركة، والأنواع المتقاطعة
الأسماء المستعارة للأنواع الأوليةأنواع الاتحاد (Union Types)التعامل مع أنواع الاتحادالأنواع اللفظية (Literal Types)أنواع التقاطع (Intersection Types)دمج الأسماء المستعارة للأنواعملخص: تجميعات الأنواع المتقدمة8التعدادات (Enums) بطريقة Luau
نمط Enum في Luauالتعدادات الرقمية باستخدام الجداولتعدادات النصوص كاتحادات (Unions)استخدام تعدادات الاتحاد الحرفيةتجميد الجداول الثابتةملخص: التعدادات (Enums) بطريقة Luau3الجداول المحددة الأنواع: المصفوفات والخرائط
المصفوفات المحددة الأنواعإضافة العناصر وقراءتهاما هو نوع الخريطة (Map)؟التصريح عن الخرائط والوصول إليهاالتكرار على الجداولالجداول متعدده الأشكالالمصفوفات المحددة الأنواع متعددة الأبعادtable.unpack والوسائط المتغيرة (Varargs)ملخص: المصفوفات والخرائط6تحديد أشكال الجداول (Typing Table Shapes)
توضيحات أشكال الجداول المضمنةأسماء مستعارة للأنواع لأشكال الجداولالخصائص الاختياريةأشكال الجداول مقابل الجداول الحرةتوسيع أشكال الجداولإضافة الدوارل إلى أشكال الجداولSelf والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول9الأنواع المعممة (Generics): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممة