الدوال التي لا تُعيد قيمة
جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 25 من 80.
الكثير من الدوال لا تحسب قيمة. بل تقوم بشيء ما: تطبع رسالة، أو تحدّث جدولًا، أو تحفظ الحالة. في Luau يمكنك إضافة تعليق توضيحي بأن الدالة لا تُرجع أي شيء باستخدام نوع الإرجاع الفارغ ():
local function logMessage(message: string): ()
print(message)
end
local counter = 0
local function incrementCounter(): ()
counter += 1
endإذا كنت قد رأيت TypeScript، فإن () تؤدي دور void، لكن طريقة كتابتها في Luau هي زوج من الأقواس الفارغة، أي حرفيًا «صفر قيم مُرجعة».
التعليق التوضيحي اختياري: اتركه إن شئت، وسيستنتج Luau أن الدالة لا تُرجع أي شيء. كتابة : () صراحةً توثّق قصدك: يعرف كل من يقرأ التوقيع أن هذه الدالة تُستدعى لإحداث آثار جانبية، لا للحصول على نتيجتها.
لا يتغير شيء أثناء وقت التشغيل (كالمعتاد): فالدالة التي لا تحتوي على قيمة return تُنتج ببساطة nil إذا حاولت التقاط نتيجتها: تمامًا كما في Lua العادية.
التحدي
سهلاكتب دالتين تطبعان ولا تُرجعان أي شيء.
- اكتب
local function displayWelcome(userName: string): ()التي تطبع`Welcome, {userName}!`. - اكتب
local function logError(errorMessage: string): ()التي تطبع`ERROR: {errorMessage}`. - استدعِ
displayWelcome("Alice")، ثمlogError("Invalid input").
اضغط على تشغيل Code: يعرض الناتج Welcome, Alice! وERROR: Invalid input.
جرّب بنفسك
-- 1) displayWelcome(userName: string): ()
-- 2) logError(errorMessage: string): ()
-- 3) استدعِ displayWelcome("Alice")، ثم logError("Invalid input")
جميع دروس مقدمة إلى Luau
1البدء مع Luau
ما هي Luau؟لماذا نستخدم Luau؟أول كود لك بلغة Luauفحص الأنواع وأنماط الأخطاءملخص: مقدمة إلى Luau4العمل مع الدوال
تحديد أنواع المعاملات والقيم المُعادةتحديد أنواع الدوال المجهولةالدوال التي لا تُعيد قيمةالمعاملات الاختياريةالقيم الافتراضية للمعاملاتالقيم الافتراضية للمنطقيةالدوال ذات المعاملات المتغيرةتعريف أنواع الدوالمراجعة: الدوال ذات الأنواع المحددة2الأنواع الأساسية
الأعداد والسلاسل النصية والقيم المنطقيةالنوع 'any': مخرج عند الضرورةالنوع 'unknown'الأنواع الخالية والاختياريةاستدلال الأنواع عمليًاالتصريحات الصريحة للأنواعمراجعة: تدريب على الأنواع الأساسية5الأسماء المستعارة، الأنواع المشتركة، والأنواع المتقاطعة
الأسماء المستعارة للأنواع الأوليةأنواع الاتحاد (Union Types)التعامل مع أنواع الاتحادالأنواع اللفظية (Literal Types)أنواع التقاطع (Intersection Types)دمج الأسماء المستعارة للأنواعملخص: تجميعات الأنواع المتقدمة3الجداول محددة الأنواع: المصفوفات والخرائط
المصفوفات محددة الأنواعإضافة العناصر وقراءتهاما نوع Map؟تعريف الخرائط والوصول إليهاالتكرار عبر الجداولالجداول ذات البُنى المختلطةقراءة شبكةإنشاء شبكةtable.unpackمراجعة: المصفوفات والخرائط6تحديد أشكال الجداول (Typing Table Shapes)
توضيحات أشكال الجداول المضمنةأسماء مستعارة للأنواع لأشكال الجداولالخصائص الاختياريةأشكال الجداول مقابل الجداول الحرةتوسيع أشكال الجداولإضافة الدوارل إلى أشكال الجداولSelf والدوال المسبوقة بنقطتين (Colon Methods)ملخص: تعريف أشكال الجداول9الأنواع المعممة (Generics): نظرة أولى
المشكلة التي تحلها الأنواع المعممةدالة هوية معممةاستخدام دالة معممةالمصفوفات المعممةأسماء مستعارة للأنواع المعممةملخص: الدوال المعممةتدرّب بنفسك: مترجم Luau عبر الإنترنت