أنواع الاتحاد (Union Types)
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 31 من 73.
أحيانًا لا يكفي type واحد. قد يصل معرّف المستخدم بالشكل "user123" أو بالشكل 42. في Lua العادية، كنت ستأمل أن تسير الأمور على ما يرام؛ أما Luau فتمنحك union types: وتُقرأ العلامة | بمعنى "أو":
local userId: number | string
userId = "user123" -- ✓ يُسمح بـ string
userId = 42 -- ✓ يُسمح بـ number
userId = true -- ✗ خطأ في النوع: boolean ليس في الـ unionيمكن للـ variable أن يحتوي على أي member من union، وعلى تلك الأعضاء فقط. وهذا هو الفرق الجوهري عن any: يظل union صارمًا بشأن ما هو allowed، مع منحك المرونة التي تحتاج إليها.
تكون unions مفيدة بشكل خاص لمعلمات function التي تقبل تنسيقات إدخال متعددة:
function printId(id: number | string): ()
print(id)
end
printId(42) -- يعمل مع رقم
printId("user123") -- يعمل مع سلسلةأنت تعرف بالفعل string?. لقد كان ذلك أول union لك! إنه مجرد اختصار لـ string | nil. في الدرس التالي ستتعلم كيفية العمل بأمان مع قيمة union بعد حصولك عليها.
التحدي
سهلأنشئ function باسم printId يأخذ id: number | string ويطبعه: نوع إرجاع صريح ().
صرّح عن متغير status من النوع string | number، مع تهيئته إلى "<code>active".
ثم، بالترتيب:
- استدعِ
printId(42) - استدعِ
printId("<code>user123") - اطبع
status - أعد إسناد
statusإلى200واطبعه مرة أخرى
أربعة أسطر من الناتج إجمالًا.
جرّب بنفسك
-- اكتب الكود هنا
-- printId(id: number | string): ()
-- local status: string | number = النص الدقيق من التعليمات
-- استدعِ printId(42)، printId(النص الدقيق من التعليمات)،
-- اطبع status، أعد التعيين إلى 200، اطبع مرة أخرى
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس مقدمة إلى Luau
1البدء مع Luau
ما هي Luau؟لماذا نستخدم Luau؟أول كود لك بلغة Luauفحص الأنواع وأنماط الأخطاءملخص: مقدمة إلى Luau4العمل مع الدوال
تحديد أنواع المعاملات والقيم المرجعةتحديد أنواع الدوال المجهولةالدوال التي لا ترجع شيئاًالمعاملات الاختياريةالقيم الافتراضية للمعاملاتالدوال متغيرة المعاملاتتعريف أنواع الدوالملخص: الدوال محددة الأنواع7المشروع: مدير المهام مع أنواع البيانات
المشروع: هيكل المهامدالة لإضافة تفاصيل مهمة2الأنواع الأساسية
الأنواع الأساسية: num و str و boolالنوع 'any': مخرج الطوارئالنوع 'unknown'أنواع Nil والأنواع الاختياريةاستنتاج الأنواع في التطبيق العمليتوضيحات الأنواع الصريحةملخص: تدريبات على الأنواع الأساسية5الأسماء المستعارة، الأنواع المشتركة، والأنواع المتقاطعة
الأسماء المستعارة للأنواع الأوليةأنواع الاتحاد (Union Types)التعامل مع أنواع الاتحادالأنواع اللفظية (Literal Types)أنواع التقاطع (Intersection Types)دمج الأسماء المستعارة للأنواعملخص: تجميعات الأنواع المتقدمة3الجداول المحددة الأنواع: المصفوفات والخرائط
المصفوفات المحددة الأنواعإضافة العناصر وقراءتهاما هو نوع الخريطة (Map)؟التصريح عن الخرائط والوصول إليهاالتكرار على الجداولالجداول متعدده الأشكالالمصفوفات المحددة الأنواع متعددة الأبعادtable.unpack والوسائط المتغيرة (Varargs)ملخص: المصفوفات والخرائط6تحديد أشكال الجداول (Typing Table Shapes)
توضيحات أشكال الجداول المضمنةأسماء مستعارة للأنواع لأشكال الجداولالخصائص الاختياريةأشكال الجداول مقابل الجداول الحرةتوسيع أشكال الجداولإضافة الدوارل إلى أشكال الجداولSelf والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول9الأنواع المعممة (Generics): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممةتدرّب بنفسك: مترجم Lua عبر الإنترنت