أمان القيم الخالية (Nil) في الوضع الصارم
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy — الدرس 71 من 73.
أكثر أسباب توقف Lua شيوعاً هو "attempt to index nil" — وهو كود يفترض وجود قيمة بينما هي غير موجودة. حل Luau هو انضباط nil: تحت وضع --!strict، لا يمكن لـ string العادي أن يكون nil على الإطلاق. إذا كان nil إمكانية واردة، فيجب أن يوضح النوع ذلك باستخدام ?:
--!صارم
local nickname: string? = nil -- حسناً: string أو nil
local username: string = nil -- ✗ خطأ نوع في الوضع الصارمهذا الانضباط يعمل في الاتجاهين: عند إعطائك string?، لن يسمح لك الوضع الصارم لاستخدامه كـ string حتى تقوم بـ استبعاد nil. أداة الفحص القياسية هي المقارنة العادية، التي تقوم بالتضييق تماماً مثل حارس typeof:
local function shout(name: string?): string
if name ~= nil then
return string.upper(name) -- name هو string هنا
end
return "NOBODY"
endعندما يكون nil خطأً برمجياً (bug) بدلاً من حالة صالحة، استخدم assert: بعد assert(x ~= nil) يتعامل الفاحص مع x كـ non-nil لباقي النطاق — وفي وقت التشغيل يتوقف البرامج بـ assert مبكراً عند نقطة الافتراض الخاطئ، بدلاً من حدوث الخطأ في مكان آخر بعيد.
الفائدة: يجبرك الفاحص على التعامل مع كل قيمة "قد تكون مفقودة" أثناء التحرير، ولا يحدث خطأ وقت التشغيل ببساطة أبداً.
التحدي
سهلقم بمعالجة حقول الملف الشخصي للمستخدم التي قد تكون مفقودة. ابدأ ملفك بـ --!strict.
getDisplayName(fullName: string?): string— تُرجعfullNameإذا لم تكنnil، وإلا تُرجع"Anonymous User".formatEmail(email: string?): string— تُرجع البريد الإلكتروني بحروف صغيرة (string.lower) إذا لم يكنnil، وإلا تُرجع"No email provided".getUserInfo(name: string?, email: string?): string— تستخدم كلا الدالتين وتُرجع`Name: {getDisplayName(name)}, Email: {formatEmail(email)}`(أي بالشكلName: [processed name], Email: [processed email]).
ثم اطبع، كل منها في سطر مستقل:
getDisplayName("John Smith")getDisplayName(nil)formatEmail("ALICE@EXAMPLE.COM")formatEmail(nil)getUserInfo("Bob Johnson", "bob@test.com")getUserInfo(nil, nil)getUserInfo("Sarah Wilson", nil)
جرّب بنفسك
--!strict
-- اكتب الكود هنا
-- 1) getDisplayName(fullName: string?): string — nil-check, fallback "Anonymous User"
-- 2) formatEmail(email: string?): string — string.lower or "No email provided"
-- 3) getUserInfo(name: string?, email: string?): string — ادمج كليهما
-- 4) اطبع استدعاءات الاختبار السبعة من المهمة
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس مقدمة إلى 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) بطريقة Luau11مواضيع متقدمة
تأكيدات الأنواع (Type Assertions)حراس الأنواع باستخدام typeofالنوع neverأمان القيم الخالية (Nil) في الوضع الصارمتوقيعات الفهارس (Index Signatures)مراجعة: ضبط الأنواع بدقة3الجداول المحددة الأنواع: المصفوفات والخرائط
المصفوفات المحددة الأنواعإضافة العناصر وقراءتهاما هو نوع الخريطة (Map)؟التصريح عن الخرائط والوصول إليهاالتكرار على الجداولالجداول متعدده الأشكالالمصفوفات المحددة الأنواع متعددة الأبعادtable.unpack والوسائط المتغيرة (Varargs)ملخص: المصفوفات والخرائط6تحديد أشكال الجداول (Typing Table Shapes)
توضيحات أشكال الجداول المضمنةأسماء مستعارة للأنواع لأشكال الجداولالخصائص الاختياريةأشكال الجداول مقابل الجداول الحرةتوسيع أشكال الجداولإضافة الدوارل إلى أشكال الجداولSelf والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول9الأنواع المعممة (Generics): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممة