عرض مصدر PHP/returning values

<noinclude>{{DISPLAYTITLE:إعادة القيم في PHP}}</noinclude>
يمكن إعادة القيم باستخدام عبارة <code>[[PHP/Control Structures/return|return]]</code> الاختيارية، ويمكن إعادة أيّ نوع من أنواع القيم ومن ضمنها المصفوفات والكائنات. يؤدي استخدام هذه العبارة إلى إيقاف تنفيذ الدالة فورًا والعودة إلى السطر الذي استدعيت منه تلك الدالة. راجع <code>[[PHP/Control Structures/return|return]]</code> للمزيد من المعلومات.

ملاحظة: إن لم تُستخدم العبارة <code>[[PHP/Control Structures/return|return]]</code> فإنّ الدالة تعيد القيمة NULL.

== استخدام <code>[[PHP/Control Structures/return|return]]</code> ==
المثال 1: استخدام عبارة <code>[[PHP/Control Structures/return|return]]</code>
<syntaxhighlight lang="php">

<?php
function square($num)
{
    return $num * $num;
}
echo square(4);   // outputs '16'.
?>
</syntaxhighlight>

لا يمكن للدالة أن تعيد قيمًا متعدّدة، ولكن يمكن الحصول على نتائج مشابهة وذلك بإعادة مصفوفة من الدالة.

المثال 2: إعادة مصفوفة من الدالة للحصول على قيم متعدّدة
<syntaxhighlight lang="php">


<?php
function small_numbers()
{
    return array (0, 1, 2);
}
list ($zero, $one, $two) = small_numbers();
?>
</syntaxhighlight>

لإعادة مرجع من الدالة، يمكن استخدام المعامل & عند التصريح عن الدالة وعند إسناد القيمة المعادة إلى متغير:

المثال 3: إعادة مرجعية من دالة
<syntaxhighlight lang="php">

<?php
function &returns_reference()
{
    return $someref;
}

$newref =& returns_reference();
?>
</syntaxhighlight>

للمزيد من المعلومات حول المراجع، يرجى مراجعة فصل توضيح المراجع.

== التصريحات من نوع return ==
يدعم الإصدار السابع من اللغة التصريحات من نوع return، وكما هو الحال في التصريحات من نوع argument فإن هذا النوع من التصريحات يحدّد نوع القيمة التي ستعيدها الدالة. جميع الأنواع المتاحة في التصريحات من نوع argument متاحة في التصريحات من نوع return.

يؤثر الوضع الصارم strict على التصريحات من نوع return. تحوّل القيم المعادة في الوضع الضعيف قسرًا إلى النوع الصحيح إن لم تكن كذلك، أما في الوضع الصارم فإنّ القيم المعادة يجب أن تكون من النوع الصحيح وفيما عدا ذلك سيُطلق خطأ من نوع TypeError.

ملاحظة: عند تجاوز التابع الأب، يجب أن تتطابق التوابع الأبناء مع أي تصريح من نوع return في التابع الأب. وإن لم يعرّف التابع الأب نوع الإعادة، فيمكن للتابع الابن أن يقوم بذلك.

== أمثلة ==
المثال 4: تصريح من نوع return بسيط
<syntaxhighlight lang="php">

<?php
function sum($a, $b): float {
    return $a + $b;
}
// لاحظ أن القيمة المرجعة هي من نوع الأعداد العشرية
var_dump(sum(1, 2));
?>
</syntaxhighlight>

تعطي الشيفرة السابقة المخرجات التالية:
<syntaxhighlight lang="php">

float(3)
</syntaxhighlight>

المثال 5: تفعيل الوضع الصارم
<syntaxhighlight lang="php">

<?php
declare(strict_types=1);

function sum($a, $b): int {
    return $a + $b;
}

var_dump(sum(1, 2));
var_dump(sum(1, 2.5));
?>
</syntaxhighlight>

يعطي المثال أعلاه المخرجات التالية:
<syntaxhighlight lang="php">

int(3)

Fatal error: Uncaught TypeError: Return value of sum() must be of the type integer, float returned in - on line 5 in -:5
Stack trace:
#0 -(9): sum(1, 2.5)
#1 {main}
  thrown in - on line 5
</syntaxhighlight>

المثال 6: إعادة كائن
<syntaxhighlight lang="php">

<?php
class C {}

function getC(): C {
    return new C;
}

var_dump(getC());
?>
يعطي المثال أعلاه النتيجة التالية:

object(C)#1 (0) {
}
</syntaxhighlight>

== مصادر ==
* [http://php.net/manual/en/functions.returning-values.php صفحة Returning Values في توثيق PHP الرسمي.]
[[تصنيف:PHP|{{SUBPAGENAME}}]]
[[تصنيف:PHP Functions|{{SUBPAGENAME}}]]