Menu
CoddyTech

الدوال التي لا تُعيد قيمة

جزء من قسم مقدمة إلى 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 العادية.

challenge icon

التحدي

سهل

اكتب دالتين تطبعان ولا تُرجعان أي شيء.

  1. اكتب local function displayWelcome(userName: string): () التي تطبع `Welcome, {userName}!`.
  2. اكتب local function logError(errorMessage: string): () التي تطبع `ERROR: {errorMessage}`.
  3. استدعِ 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

تدرّب بنفسك: مترجم Luau عبر الإنترنت