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

جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 57 من 80.

تجعل الأرقام السجلات غامضة: رؤية 2 لا تخبرك بالكثير، بينما رؤية "down" تخبرك بكل شيء. ولإنشاء تعدادات قابلة للقراءة، تُعد أنواع الاتحاد الحرفي في Luau الأداة المناسبة: نوعًا تكون أعضاؤه سلاسل نصية محددة حرفيًا:

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

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

يمكن لمتغير مُعرّف بالنوع Direction أن يحتوي على تلك السلاسل الأربع ولا شيء غيرها. أخطئ في كتابة إحداها وسيلتقط المدقّق الخطأ فورًا: لن يصل الخلل أبدًا إلى اللاعب.

في وقت التشغيل، تكون القيم سلاسل نصية عادية. اطبعها، أو ادمجها، أو قارنها باستخدام ==. كل ما تعرفه عن السلاسل النصية ينطبق عليها:

print(facing)            -- للأعلى
print(`facing {facing}`) -- facing للأعلى

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

التحدي

سهل

خزّن اتجاهًا لا يمكن أن يكون إلا واحدًا من أربعة أسماء.

اكتب type Direction = "up" | "down" | "left" | "right".
صرّح عن local facing: Direction = "left".
اطبع facing، ثم `The player moves {facing}`.

اضغط على Run Code: يُظهر الناتج left وThe player moves left.

جرّب بنفسك

-- 1) عرّف النوع Direction بوصفه اتحادًا لأربع سلاسل نصية
-- 2) local facing: Direction = "left"
-- 3) اطبع facing، ثم الجملة

جميع دروس مقدمة إلى Luau

1البدء مع Luau

ما هي Luau؟لماذا نستخدم Luau؟أول كود لك بلغة Luau فحص الأنواع وأنماط الأخطاء ملخص: مقدمة إلى Luau

4العمل مع الدوال

تحديد أنواع المعاملات والقيم المُعادة تحديد أنواع الدوال المجهولة الدوال التي لا تُعيد قيمة المعاملات الاختيارية القيم الافتراضية للمعاملات القيم الافتراضية للمنطقية الدوال ذات المعاملات المتغيرة تعريف أنواع الدوال مراجعة: الدوال ذات الأنواع المحددة

7مشروع: مدير مهام محدد الأنواع

مشروع: بنية المهمة دالة لإضافة مهمة

دالة لتغيير حالة المهمة

دالة: عرض المهام حسب الحالة

دالة: طباعة ملخص المهام

حلقة الأوامر: إضافة

حلقة الأوامر: عرض وإنهاء

حلقة الأوامر: ملخص

10مشروع: نظام مخزون عام

مشروع: عنصر المخزون دالة: إضافة عناصر

قائمة الأسلحة

دالة: العثور على عنصر حسب المعرّف

أنواع محددة من المخزون

دالة: وصف العناصر

الإجابة عن استفسارات العناصر

2الأنواع الأساسية

الأعداد والسلاسل النصية والقيم المنطقية النوع 'any': مخرج عند الضرورة النوع 'unknown'الأنواع الخالية والاختيارية استدلال الأنواع عمليًا التصريحات الصريحة للأنواع مراجعة: تدريب على الأنواع الأساسية

5الأسماء المستعارة، الأنواع المشتركة، والأنواع المتقاطعة

الأسماء المستعارة للأنواع الأولية أنواع الاتحاد (Union Types)التعامل مع أنواع الاتحاد الأنواع اللفظية (Literal Types)أنواع التقاطع (Intersection Types)دمج الأسماء المستعارة للأنواع ملخص: تجميعات الأنواع المتقدمة

8التعدادات (Enums) بطريقة Luau

نمط Enum في Luau التعدادات الرقمية باستخدام الجداولتعدادات النصوص كاتحادات (Unions)استخدام تعدادات الاتحاد الحرفية تجميد الجداول الثابتة ملخص: التعدادات (Enums) بطريقة Luau

11موضوعات متقدمة

تأكيدات الأنواع حراس الأنواع باستخدام typeof النوع never سلامة القيم الفارغة في الوضع الصارم تواقيع الفهارس مراجعة: أنواع قيم الإعدادات مراجعة: ضبط الأنواع بدقة

3الجداول محددة الأنواع: المصفوفات والخرائط

المصفوفات محددة الأنواع إضافة العناصر وقراءتها ما نوع Map؟تعريف الخرائط والوصول إليها التكرار عبر الجداول الجداول ذات البُنى المختلطة قراءة شبكة إنشاء شبكة table.unpack مراجعة: المصفوفات والخرائط

6تحديد أشكال الجداول (Typing Table Shapes)

توضيحات أشكال الجداول المضمنة أسماء مستعارة للأنواع لأشكال الجداول الخصائص الاختيارية أشكال الجداول مقابل الجداول الحرة توسيع أشكال الجداول إضافة الدوارل إلى أشكال الجداول Self والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول

9الأنواع المعممة (Generics): نظرة أولى

المشكلة التي تحلها الأنواع المعممة دالة هوية معممة استخدام دالة معممة المصفوفات المعممة أسماء مستعارة للأنواع المعممة ملخص: الدوال المعممة

تدرّب بنفسك: مترجم Luau عبر الإنترنت