دالة error()

جزء من قسم Logic & Flow في رحلة Lua على Coddy — الدرس 32 من 54.

أحياناً يحتاج الكود الخاص بك إلى التوقف فوراً عندما يحدث خطأ ما. توفر لغة Lua وظيفة error() للتعامل مع هذه المواقف عن طريق إثارة خطأ وإيقاف تنفيذ السكريبت.

تأخذ الدالة error() رسالة كمعامل (argument) لها وتوقف البرنامج، حيث تعرض هذه الرسالة لتوضيح الخطأ الذي حدث. إليك الصيغة الأساسية:

error("Something went wrong!")

هذا مفيد بشكل خاص عند التحقق من صحة مدخلات الدالة. على سبيل المثال، إذا كانت الدالة تتوقع رقماً موجباً ولكنها استلمت رقماً سالباً، يمكنك استخدام error() لمنع المزيد من التنفيذ:

function calculateSquareRoot(num)
    if num < 0 then
        error("Cannot calculate square root of a negative number")
    end
    return math.sqrt(num)
end

عندما يتم استدعاء error()، يتوقف البرنامج فوراً عند تلك النقطة ويعرض رسالة الخطأ المخصصة الخاصة بك. يساعدك هذا في اكتشاف المشكلات مبكراً والتواصل بوضوح حول ما حدث بشكل خاطئ، مما يجعل الكود الخاص بك أكثر موثوقية وأسهل في تصحيح الأخطاء.

ورقة مرجعية

تقوم دالة error() بإيقاف تنفيذ البرنامج وعرض رسالة خطأ:

error("Something went wrong!")

حالة استخدام شائعة - التحقق من صحة مدخلات الدالة:

function calculateSquareRoot(num)
    if num < 0 then
        error("Cannot calculate square root of a negative number")
    end
    return math.sqrt(num)
end

عند استدعاء error()، يتوقف البرنامج فوراً ويعرض رسالة الخطأ المخصصة.

جرّب بنفسك

لا يتضمّن هذا الدرس تحدّيًا برمجيًا.