الاستدعاءات المحمية باستخدام pcall()

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

بينما تقوم error() بإيقاف برنامجك عندما يحدث خطأ ما، قد ترغب أحياناً في التعامل مع الأخطاء دون أن يتوقف البرنامج بشكل مفاجئ. تتيح لك دالة pcall() في لغة Lua تنفيذ الكود الذي قد يفشل بأمان.

الاسم pcall() يرمز إلى "protected call" (النداء المحمي). فهو يقوم بتغليف استدعاء الدالة في طبقة حماية تلتقط أي أخطاء. وبدلاً من توقف برنامجك عن العمل، يعيد pcall() معلومات حول ما حدث.

إليك الصيغة الأساسية:

local status, result = pcall(functionName, arg1, arg2)

تعيد الدالة pcall() قيمتين. الأولى هي حالة منطقية (boolean): true إذا نجحت الدالة، أو false في حال حدوث خطأ. تعتمد القيمة الثانية على الحالة—إذا كانت ناجحة، فهي القيمة التي تعيدها الدالة؛ أما إذا كان هناك خطأ، فهي رسالة الخطأ.

إليك مثال عملي:

function divide(a, b)
    if b == 0 then
        error("Cannot divide by zero")
    end
    return a / b
end

local success, result = pcall(divide, 10, 0)

if success then
    print("Result: " .. result)
else
    print("Error caught: " .. result)
end

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

التحدي

سهل

اكتب دالة safeCalculate تأخذ operation، و a، و b وتعيد نتيجة الحساب أو رسالة خطأ.

يجب أن تستخدم الدالة pcall() لإجراء العملية الحسابية المطلوبة بأمان. قم بإنشاء دالة داخلية تقوم بإجراء الحساب بناءً على سلسلة العملية (operation string)، ثم قم بتغليفها بـ pcall() لالتقاط أي أخطاء.

المنطق:

قم بإنشاء دالة داخلية تتحقق من نوع العملية وتجري الحساب
بالنسبة لـ "add"، أعد a + b
بالنسبة لـ "subtract"، أعد a - b
بالنسبة لـ "multiply"، أعد a * b
بالنسبة لـ "divide"، تحقق مما إذا كان b يساوي 0 واستدعِ error("Division by zero") إذا كان ذلك صحيحاً، وإلا أعد a / b
لأي عملية أخرى، استدعِ error("Invalid operation")
استخدم pcall() لتنفيذ الدالة الداخلية
إذا نجحت العملية، أعد "Result: " متبوعاً بالنتيجة
إذا حدث خطأ، أعد "Error: " متبوعاً برسالة الخطأ

المعاملات (Parameters):

operation (string): العملية المراد تنفيذها ("add" أو "subtract" أو "multiply" أو "divide")
a (number): المعامل الأول
b (number): المعامل الثاني

المخرجات (Returns): سلسلة نصية تحتوي إما على "Result: " متبوعاً بنتيجة الحساب، أو "Error: " متبوعاً برسالة الخطأ (string)

ورقة مرجعية

تسمح لك وظيفة pcall() (الاستدعاء المحمي - protected call) بتنفيذ الكود الذي قد يفشل بأمان دون أن يتسبب ذلك في توقف برنامجك بشكل مفاجئ.

الصيغة الأساسية:

local status, result = pcall(functionName, arg1, arg2)

تعيد pcall() قيمتين:

status: تكون true إذا نجحت الوظيفة، و false في حال حدوث خطأ.
result: القيمة التي تعيدها الوظيفة في حال النجاح، أو رسالة الخطأ في حال حدوث خطأ.

مثال:

function divide(a, b)
    if b == 0 then
        error("Cannot divide by zero")
    end
    return a / b
end

local success, result = pcall(divide, 10, 0)

if success then
    print("Result: " .. result)
else
    print("Error caught: " .. result)
end

يؤدي هذا إلى التقاط الخطأ بدلاً من تعطل البرنامج، مما يسمح للبرنامج بالاستمرار ومعالجة الخطأ بشكل سليم.

جرّب بنفسك

function safeCalculate(operation, a, b)
    -- اكتب الكود هنا
end

اختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس Logic & Flow

1التكرار المتقدم عبر الجداول

التكرار باستخدام pairs()التكرار باستخدام ipairs()pairs() مقابل ipairs()مراجعة - ورقة الشخصية

4مقدمة إلى Metatables

ما هو الـ Metatable؟setmetatable و getmetatable الـ Metamethod المسماة __index الـ Metamethod المسماة __newindex الـ Metamethod المسماة __tostring الـ Metamethods الحسابية - الجزء الأول الـ Metamethods الحسابية - الجزء الثاني ملخص - جدول للقراءة فقط

7معالجة النصوص المتقدمة

استخدام string.gsub() للاستبدال مقدمة في أنماط النصوص string.find()string.match()التكرار باستخدام string.gmatch()مراجعة - محلل ملفات السجل

3مفاهيم الدوال المتقدمة

إرجاع قيم متعددة الدوال متغيرة الوسائط (...)الدوال كقيم من الدرجة الأولى الدوال المجهولة ما هو الـ Closure؟ملخص - معالج أحداث بسيط

6معالجة الأخطاء

دالة error()الاستدعاءات المحمية باستخدام pcall()مراجعة - القسمة الآمنة

9Coroutines للمبتدئين

ما هو الـ Coroutine؟إنشاء واستئناف الـ coroutine الإيقاف المؤقت باستخدام coroutine.yield()resume و yield التحقق من حالة الـ Coroutine مراجعة - مولد الأرقام مراجعة - رياضيات المتجهات