كيفية إعادة قيمة من دالة في PHP

تمت الكتابة بواسطة: عبد الحكيم

تارخ آخر تحديث: 01 سبتمبر 2024

محتوى المقال

كيفية إعادة قيمة من دالة في PHP

في PHP، تُستخدم الدوال لأداء مهام محددة، ويمكن أن تُرجع الدالة قيمة إلى الكود الذي قام باستدعائها. تُعد عملية إعادة القيم من الدوال جزءًا مهمًا من البرمجة في PHP، حيث تتيح لك نقل البيانات بين أجزاء مختلفة من البرنامج. في هذا المقال، سنستعرض كيفية إعادة قيمة من دالة في PHP مع أمثلة توضيحية.

ما هي إعادة القيمة في PHP؟

إعادة القيمة من دالة تعني إرسال نتيجة أو قيمة معينة من داخل الدالة إلى الكود الذي قام باستدعائها. يتم ذلك باستخدام الكلمة المفتاحية return داخل الدالة. بعد تنفيذ الأمر return، تتوقف الدالة عن العمل، ويتم إرجاع القيمة المحددة إلى المكان الذي استُدعيت منه الدالة.

كيفية إعادة قيمة من دالة

لإرجاع قيمة من دالة في PHP، اتبع الخطوات التالية:

  1. تعريف الدالة: قم بكتابة دالة باستخدام الكلمة المفتاحية function، وقم بتحديد اسم الدالة.
  2. استخدام return: داخل الدالة، استخدم الكلمة المفتاحية return لإرجاع القيمة التي ترغب فيها.
  3. استدعاء الدالة: قم باستدعاء الدالة من أي مكان في الكود، واحفظ النتيجة في متغير إذا كنت ترغب في استخدام القيمة المُعادة.

مثال على إعادة قيمة من دالة

لنفترض أننا نريد إنشاء دالة تُرجع مجموع رقمين:

<?php
function calculateSum($a, $b) {
    return $a + $b;
}

// استدعاء الدالة وتخزين النتيجة
$sum = calculateSum(5, 10);
echo "المجموع: " . $sum;
?>

في هذا المثال، الدالة calculateSum تُرجع مجموع الرقمين $a و$b. النتيجة تُخزن في المتغير $sum، ويتم عرضها باستخدام echo.

إرجاع أنواع متعددة من القيم

يمكن للدوال في PHP أن تُرجع أي نوع من البيانات مثل الأعداد، السلاسل النصية، المصفوفات، أو حتى الكائنات (Objects).

مثال على إرجاع مصفوفة

لنفترض أننا نريد إنشاء دالة تُرجع مصفوفة تحتوي على أول 3 أعداد زوجية:

<?php
function getEvenNumbers() {
    return [2, 4, 6];
}

// استدعاء الدالة وتخزين النتيجة
$numbers = getEvenNumbers();
print_r($numbers);
?>

في هذا المثال، تقوم الدالة getEvenNumbers بإرجاع مصفوفة تحتوي على الأعداد الزوجية 2، 4، و6. بعد استدعاء الدالة، نعرض المصفوفة باستخدام print_r.

إيقاف تنفيذ الدالة بعد return

بمجرد تنفيذ return في الدالة، يتوقف تنفيذ الدالة مباشرةً. أي تعليمات تأتي بعد return لن يتم تنفيذها.

مثال على استخدام return لإيقاف التنفيذ

لنفترض أن لدينا دالة تتحقق من رقم وتُرجع "زوجي" أو "فردي" ثم تتوقف:

<?php
function checkEvenOdd($number) {
    if ($number % 2 == 0) {
        return "زوجي";
    }
    return "فردي";
}

// استدعاء الدالة مع عدد زوجي
$result = checkEvenOdd(4);
echo $result; // سيعرض "زوجي"
?>

في هذا المثال، إذا كان الرقم زوجيًا، تقوم الدالة checkEvenOdd بإرجاع "زوجي" وتوقف التنفيذ. وإذا كان فرديًا، تُرجع "فردي".

إرجاع قيم متعددة باستخدام مصفوفة

إذا كنت بحاجة إلى إرجاع أكثر من قيمة من دالة واحدة، يمكنك استخدام مصفوفة.

مثال على إرجاع قيم متعددة

لننشئ دالة تُرجع مجموع وفرق رقمين:

<?php
function calculateOperations($a, $b) {
    $sum = $a + $b;
    $difference = $a $b;
    return ['sum' => $sum, 'difference' => $difference];
}

// استدعاء الدالة وتخزين النتائج
$results = calculateOperations(10, 5);
echo "المجموع: " . $results['sum'] . ", الفرق: " . $results['difference'];
?>

في هذا المثال، تقوم الدالة calculateOperations بإرجاع مصفوفة تحتوي على مجموع وفرق الرقمين المدخلين. نستخدم المصفوفة للوصول إلى النتائج وعرضها.

الخلاصة

إرجاع القيم من الدوال في PHP يتيح لك بناء دوال أكثر مرونة وقوة. باستخدام الكلمة المفتاحية return، يمكنك إرسال نتائج العمليات الحسابية، النصوص، المصفوفات، أو حتى الكائنات إلى أجزاء أخرى من البرنامج. يمكن أن يكون ذلك مفيدًا في تجزئة الكود، تحسين تنظيمه، وجعله أكثر كفاءة.

طور مهاراتك: مقالات يجب قراءتها في البرمجة