المعاملات الاختيارية
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy — الدرس 25 من 73.
في لغة Lua العادية، كان بإمكانك دائماً حذف وسائط الدالة (arguments) — حيث تصبح الوسائط المفقودة تلقائياً وبشكل غير معلن nil، وكان نسيان التعامل مع ذلك مصدراً كلاسيكياً للأخطاء البرمجية. تجعل Luau هذه إمكانية صريحة: أضف ? إلى نوع المعلمة (parameter) لتمييزها كـ اختيارية (optional).
function greet(name: string, title: string?): string
if title then
return `{title} {name}`
end
return `Hello, {name}`
end
print(greet("Ada")) -- مرحباً، Ada
print(greet("Ada", "Dr.")) -- د. Adaُتقرأ string? على أنها "string أو nil". يمكن للمستدعين إمرار سلسلة نصية أو تجاوز الوسيط بالكامل؛ بينما تكون المعلمات التي لا تحتوي على ? مطلوبة، ويقوم أداة الفحص (checker) بتمييز الاستدعاءات التي تتجاهلها.
داخل الدالة، قد تكون المعلمة الاختيارية nil، لذا قم بعمل check لها قبل using استخدامها — النمط القياسي هو if title then ... end. إذا تجاوزت الفحص وربطت nil داخل سلسلة نصية، فستحصل على نفس خطأ وقت التشغيل (runtime error) الذي تعطيك إياه Lua دائماً؛ لكن فاحص الأنواع ينبهك أولاً.
التحدي
سهلأنشئ دالة باسم createUserProfile تأخذ username: string (مطلوب) و displayName: string? (اختياري)، وترجع string:
- عند توفيرهما معاً، أرجع:
"Profile: [displayName] (@[username])" - عند توفير اسم المستخدم فقط، أرجع:
"Profile: @[username]"
أنشئ دالة باسم calculateDiscount تأخذ price: number (مطلوب) و membershipLevel: string? (اختياري)، وترجع number:
- عند توفير مستوى العضوية، أرجع السعر مخفضاً بنسبة 10% (اضرب في
0.9) - بخلاف ذلك، أرجع السعر دون تغيير
قم بالاستدعاء والطباعة، كل منها في سطر مستقل:
createUserProfile("john_doe", "John Doe")createUserProfile("jane_smith")calculateDiscount(100, "premium")calculateDiscount(75)
جرّب بنفسك
-- اكتب الكود هنا
-- createUserProfile(username: string, displayName: string?): string
-- calculateDiscount(price: number, membershipLevel: string?): number
-- ثم اطبع النتائج الأربع
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس مقدمة إلى 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): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممة