الأنواع اللفظية (Literal Types)
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 35 من 80.
تسمح الأنواع مثل string بأي سلسلة نصية، لكن أحيانًا لا تكون مناسبة إلا بضع قيم محددة. يستخدم النوع الحرفي القيمة نفسها بوصفها النوع:
local mode: "dark" = "dark" -- يُسمح فقط بالسلسلة النصية "dark"
local locked: true = true -- يُسمح فقط بالقيمة المنطقية trueبمفردها، تُعد الأنواع ذات القيمة الواحدة أمرًا فضوليًا. لكنها تصبح، عند جمعها مع الاتحادات، إحدى أكثر أدوات Luau فائدة: مجموعة محددة بدقة من القيم المسموح بها:
type Direction = "north" | "south" | "east" | "west"
type GameState = "menu" | "playing" | "paused" | "gameover"
local move: Direction = "north" -- ✓
local state: GameState = "playing" -- ✓
-- local bad: Direction = "diagonal" -- ✗ خطأ في النوع!بهذا، يُكتشف أثناء التحرير خطأ مطبعي مثل "nort" أو قيمة غير صالحة مثل "diagonal". أما مع string عادي، فستمضي القيمة دون أن تُكتشف، وقد تتسبب في خطأ وقت التشغيل، إن حالفك الحظ ولاحظته.
الأنواع الحرفية حساسة لحالة الأحرف ودقيقة: لا تطابق "North" القيمة "north". تُعد السلاسل النصية الحرفية الحالة الشائعة، لكن القيم الحرفية المنطقية والرقمية (في إصدارات Luau الأحدث) تعمل بالطريقة نفسها. وهذا النمط، أي اتحاد من السلاسل النصية الحرفية، هو أيضًا الطريقة التي تستعيض بها Luau عن التعدادات في اللغات الأخرى، كما سترى في فصل لاحق.
التحدي
سهلاسمح بأربعة أسماء محددة للاتجاهات فقط.
- اكتب
type Direction = "north" | "south" | "east" | "west". - اكتب
local function movePlayer(direction: Direction): stringلإرجاع`Moving {direction}`. - أعلِن
local playerDirection: Direction = "east"واطبعmovePlayer(playerDirection).
اضغط على Run Code: سيعرض الناتج Moving east.
جرّب بنفسك
-- 1) type Direction = "north" | "south" | "east" | "west"
-- 2) movePlayer(direction: Direction): string
-- 3) local playerDirection: Direction = "east"، ثم اطبع الحركة
جميع دروس مقدمة إلى Luau
1البدء مع Luau
ما هي Luau؟لماذا نستخدم Luau؟أول كود لك بلغة Luauفحص الأنواع وأنماط الأخطاءملخص: مقدمة إلى Luau4العمل مع الدوال
تحديد أنواع المعاملات والقيم المُعادةتحديد أنواع الدوال المجهولةالدوال التي لا تُعيد قيمةالمعاملات الاختياريةالقيم الافتراضية للمعاملاتالقيم الافتراضية للمنطقيةالدوال ذات المعاملات المتغيرةتعريف أنواع الدوالمراجعة: الدوال ذات الأنواع المحددة2الأنواع الأساسية
الأعداد والسلاسل النصية والقيم المنطقيةالنوع 'any': مخرج عند الضرورةالنوع 'unknown'الأنواع الخالية والاختياريةاستدلال الأنواع عمليًاالتصريحات الصريحة للأنواعمراجعة: تدريب على الأنواع الأساسية5الأسماء المستعارة، الأنواع المشتركة، والأنواع المتقاطعة
الأسماء المستعارة للأنواع الأوليةأنواع الاتحاد (Union Types)التعامل مع أنواع الاتحادالأنواع اللفظية (Literal Types)أنواع التقاطع (Intersection Types)دمج الأسماء المستعارة للأنواعملخص: تجميعات الأنواع المتقدمة3الجداول محددة الأنواع: المصفوفات والخرائط
المصفوفات محددة الأنواعإضافة العناصر وقراءتهاما نوع Map؟تعريف الخرائط والوصول إليهاالتكرار عبر الجداولالجداول ذات البُنى المختلطةقراءة شبكةإنشاء شبكةtable.unpackمراجعة: المصفوفات والخرائط6تحديد أشكال الجداول (Typing Table Shapes)
توضيحات أشكال الجداول المضمنةأسماء مستعارة للأنواع لأشكال الجداولالخصائص الاختياريةأشكال الجداول مقابل الجداول الحرةتوسيع أشكال الجداولإضافة الدوارل إلى أشكال الجداولSelf والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول9الأنواع المعممة (Generics): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممةتدرّب بنفسك: مترجم Luau عبر الإنترنت