الخصائص الاختيارية
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 41 من 80.
ليس كل حقل موجودًا دائمًا. في Lua، قراءة حقل مفقود من جدول تُرجع ببساطة nil، وهذا مرن، لكنه أيضًا ما يسمح بحدوث أخطاء مثل attempt to concatenate a nil value.
تتيح لك Luau التصريح بذلك صراحةً في الشكل: أضف ? بعد نوع الحقل لتحديد أنه اختياري:
type User = {
name: string, -- مطلوب
email: string?, -- اختياري: string أو nil
}
local alice: User = {name = "Alice", email = "alice@luau.dev"}
local bob: User = {name = "Bob"} -- ✓ لا بأس، email اختياريسبق أن تعرفت إلى ذلك مع المتغيرات: string? اختصار لـ string | nil. وتنطبق الفكرة نفسها الآن على الحقول الفردية في الشكل.
لأن الحقل الاختياري قد تكون قيمته nil، يجب أن تتحقق منه قبل استخدامه. يعمل نمط Lua المعتاد هنا، وفي الوضع الصارم يضيّق المدقّق النوع داخل الفرع:
if bob.email then
print(`email: {bob.email}`) -- هنا email عبارة عن سلسلة نصية
else
print("no email on file")
endتعني كلمة اختياري «قد يكون غائبًا». لكنها لا تعني «أي نوع». إذا كان email موجودًا، فيجب أن تظل قيمته سلسلة نصية.
التحدي
سهلاطبع جهات الاتصال التي قد لا يتوفر لها بريد إلكتروني.
- اكتب
type User = {name: string, email: string?}، ثمlocal mia: User = {name = "Mia", email = "mia@coddy.tech"}وlocal leo: User = {name = "Leo"}. - اكتب
local function printContact(user: User)لطباعة`{user.name}: {user.email}`، أو`{user.name}: no email`إذا لم يكن لديه بريد إلكتروني. - استدعِها مع
mia، ثمleo.
اضغط على Run Code: سيعرض الناتج Mia: mia@coddy.tech وLeo: no email.
جرّب بنفسك
-- 1) عرّف النوع User بحقل email اختياري، ثم عرّف mia وleo
-- 2) عرّف printContact(user: User) مع التحقق من حقل email
-- 3) استدعِها من أجل mia، ثم leo
جميع دروس مقدمة إلى 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 عبر الإنترنت