الدوال التي لا ترجع شيئاً
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy — الدرس 24 من 73.
العديد من الدوال لا تحسب قيمة — بل تفعل شيئًا ما: تطبع رسالة، تحدّث جدولاً، أو تحفظ حالة. في Luau يمكنك توضيح أن الدالة لا ترجع لا شيء باستخدام نوع الإرجاع الفارغ ():
function logMessage(message: string): ()
print(message)
end
local counter = 0
function incrementCounter(): ()
counter += 1
endإذا كنت قد تعاملت مع TypeScript من قبل، فإن () تؤدي دور void — ولكن صيغتها في Luau هي زوج من الأقواس الفارغة، أي حرفيًا "صفر من قيم الإرجاع".
هذا التوضيح اختياري: إذا تركته، ستستنتج Luau أن الدالة لا ترجع شيئًا. كتابة : () توثق قصدك بشكل صريح — أي شخص يقرأ التوقيع (signature) سيغدو عالمًا بأن هذه الدالة يُستدعى من أجل تأثيراتها الجانبية (side-effects)، وليس لنتائجها.
في وقت التشغيل لا يتغير أي شيء (كما هو المعتاد): الدالة التي لا تحتوي على قيمة return تنتج ببساطة nil إذا حاولت التقاط نتيجتها — تمامًا مثل لغة Lua العادية.
التحدي
سهلأنشئ دالة باسم displayWelcome تأخذ userName: string ولها نوع إرجاع صريح هو (). يجب أن تطبع: "Welcome to our application, [userName]!"
أنشئ دالة باسم logError تأخذ errorMessage: string مع نوع إرجاع (). يجب أن تطبع: "ERROR: [errorMessage]"
أنشئ دالة باسم processData لا تأخذ أي معاملات، مع نوع إرجاع (). يجب أن تطبع "Processing data..." ثم "Data processing complete." في السطر التالي.
قم باستدعائها بهذا الترتيب:
displayWelcome("Alice")processData()logError("Invalid input detected")displayWelcome("Bob")
جرّب بنفسك
-- اكتب الكود هنا
-- displayWelcome(userName: string): ()
-- logError(errorMessage: string): ()
-- processData(): ()
-- ثم استدعِ: displayWelcome("Alice"), processData(),
-- logError("Invalid input detected"), displayWelcome("Bob")
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس مقدمة إلى 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): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممة