سلامة القيم الفارغة في الوضع الصارم
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 77 من 80.
أكثر أعطال Lua شيوعًا هو "محاولة فهرسة nil": كود افترض وجود قيمة بينما لم تكن موجودة. إجابة Luau هي الانضباط في التعامل مع nil: في ظل --!strict، لا يمكن أبدًا أن تكون قيمة string عادية هي nil. إذا كان nil احتمالًا حقيقيًا، فيجب أن يوضّح النوع ذلك باستخدام ?:
--!صارم
local nickname: string? = nil -- صحيح: string أو nil
local username: string = nil -- ✗ خطأ في النوع في الوضع الصارميعمل هذا الانضباط في الاتجاهين: إذا كانت لديك قيمة من النوع string?، فلن يسمح لك الوضع الصارم باستخدامها كسلسلة نصية إلى أن تتحقق من أنها ليست nil. والأداة المعتادة هي مقارنة عادية، تُضيّق النوع مثلما يفعل شرط الحراسة typeof:
local function shout(name: string?): string
if name ~= nil then
return string.upper(name) -- المتغير name من النوع string هنا
end
return "NOBODY"
endعندما يكون nil خطأً برمجيًا لا حالةً صالحة، استخدم assert: بعد assert(x ~= nil)، يتعامل المدقّق مع x على أنها ليست nil حتى نهاية النطاق، وفي وقت التشغيل يتسبب التأكيد في تعطل البرنامج مبكرًا، عند موضع الافتراض الخاطئ، بدلًا من حدوث ذلك في مكان بعيد.
والنتيجة: يجبر المدقّق على معالجة كل قيمة «قد تكون مفقودة» أثناء تحريرك للكود، وبذلك لا يحدث خطأ وقت التشغيل أبدًا.
التحدي
سهلأعطِ اسمًا قد يحتاج إلى قيمة احتياطية آمنة.
- أبقِ
--!strictفي السطر الأول. - اكتب
local function getDisplayName(fullName: string?): stringلإرجاعfullNameعندما لا تكونnil، وإلا فأرجع"Anonymous User". - اطبع
getDisplayName("John Smith")وgetDisplayName(nil).
اضغط على Run Code: يُظهر الناتج John Smith وAnonymous User.
جرّب بنفسك
--!strict
-- 1) getDisplayName(fullName: string?): string، مع استخدام "Anonymous User" كقيمة بديلة
-- 2) اطبع الناتج عند استخدام "John Smith" وnil
جميع دروس مقدمة إلى Luau
1البدء مع Luau
ما هي Luau؟لماذا نستخدم Luau؟أول كود لك بلغة Luauفحص الأنواع وأنماط الأخطاءملخص: مقدمة إلى Luau4العمل مع الدوال
تحديد أنواع المعاملات والقيم المُعادةتحديد أنواع الدوال المجهولةالدوال التي لا تُعيد قيمةالمعاملات الاختياريةالقيم الافتراضية للمعاملاتالقيم الافتراضية للمنطقيةالدوال ذات المعاملات المتغيرةتعريف أنواع الدوالمراجعة: الدوال ذات الأنواع المحددة2الأنواع الأساسية
الأعداد والسلاسل النصية والقيم المنطقيةالنوع 'any': مخرج عند الضرورةالنوع 'unknown'الأنواع الخالية والاختياريةاستدلال الأنواع عمليًاالتصريحات الصريحة للأنواعمراجعة: تدريب على الأنواع الأساسية5الأسماء المستعارة، الأنواع المشتركة، والأنواع المتقاطعة
الأسماء المستعارة للأنواع الأوليةأنواع الاتحاد (Union Types)التعامل مع أنواع الاتحادالأنواع اللفظية (Literal Types)أنواع التقاطع (Intersection Types)دمج الأسماء المستعارة للأنواعملخص: تجميعات الأنواع المتقدمة8التعدادات (Enums) بطريقة Luau
نمط Enum في Luauالتعدادات الرقمية باستخدام الجداولتعدادات النصوص كاتحادات (Unions)استخدام تعدادات الاتحاد الحرفيةتجميد الجداول الثابتةملخص: التعدادات (Enums) بطريقة Luau11موضوعات متقدمة
تأكيدات الأنواعحراس الأنواع باستخدام typeofالنوع neverسلامة القيم الفارغة في الوضع الصارمتواقيع الفهارسمراجعة: أنواع قيم الإعداداتمراجعة: ضبط الأنواع بدقة3الجداول محددة الأنواع: المصفوفات والخرائط
المصفوفات محددة الأنواعإضافة العناصر وقراءتهاما نوع Map؟تعريف الخرائط والوصول إليهاالتكرار عبر الجداولالجداول ذات البُنى المختلطةقراءة شبكةإنشاء شبكةtable.unpackمراجعة: المصفوفات والخرائط6تحديد أشكال الجداول (Typing Table Shapes)
توضيحات أشكال الجداول المضمنةأسماء مستعارة للأنواع لأشكال الجداولالخصائص الاختياريةأشكال الجداول مقابل الجداول الحرةتوسيع أشكال الجداولإضافة الدوارل إلى أشكال الجداولSelf والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول9الأنواع المعممة (Generics): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممةتدرّب بنفسك: مترجم Luau عبر الإنترنت