المعاملات الاختيارية
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 25 من 73.
في Lua العادية، كان بإمكانك دائمًا حذف الوسائط: إذ تتحول الوسائط المفقودة بصمت إلى nil، وكان نسيان التعامل مع ذلك مصدرًا شائعًا للأخطاء. تجعل Luau هذا الاحتمال صريحًا: أضف ? إلى نوع إحدى المعاملات لوضع علامة على أنها اختيارية.
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». يمكن للمتصلين تمرير سلسلة نصية أو تخطي الوسيط بالكامل؛ أما المعاملات من دون ? فهي مطلوبة، ويُصدر المدقّق تحذيرًا بشأن الاستدعاءات التي تحذفها.
داخل الدالة، قد يكون المعامل الاختياري هو nil، لذا تحقّق منه قبل استخدامه: يُعدّ if title then ... end النمط القياسي. إذا تخطيت التحقق وضممت nil إلى سلسلة نصية، فستحصل على خطأ وقت التشغيل نفسه الذي كانت 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): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممةتدرّب بنفسك: مترجم Lua عبر الإنترنت