الفرق بين المراجعتين لصفحة: «PHP/array pop»

المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018

(PHP 4, PHP 5, PHP 7)

تزيل الدالة array_pop()‎ العنصر الأخير في نهاية المصفوفة وتُعيد قيمته.

الوصف

mixed array_pop ( array &$array )

تدفع دالة array_pop()‎ العنصر الأخير من المصفوفة array وتُعيد قيمته، وتقلل من طول المصفوفة array بمقدار عنصر واحد.

ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة reset()‎.

المعاملات

`array`

المصفوفة المراد الحصول على قيمة العنصر منها.

القيم المعادة

تُعيد قيمة العنصر الأخير من المصفوفة array. إذا كانت المصفوفة array فارغة (أو ليست مصفوفة)، فستعيد الدالةُ القيمةَ NULL.

الأخطاء والاستثناءات

ستنتج هذه الدالة خطأً من المستوى E_WARNING عند استعمالها على قيمةٍ لا تمثِّل مصفوفةً.

أمثلة

المثال 1: مثال على الدالة array_pop()‎

<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_pop($stack);
print_r($stack);
?>

سيبقى بعد ذلك ثلاثة عناصر فقط في المصفوفة stack$:

Array
(
    [0] => orange
    [1] => banana
    [2] => apple
)

وستُسنَد القيمة raspberry إلى المتغير fruit$ .

انظر أيضًا

الدالة array_push()‎: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
الدالة array_shift()‎: إزالة عنصر من بداية المصفوفة وإعادة قيمته.
الدالة array_unshift()‎: إضافة عنصر واحد أو أكثر لبداية المصفوفة.

مصادر

صفحة الدالة array_pop‎ في توثيق PHP الرسمي.

@@ سطر 9: / سطر 9: @@
 </syntaxhighlight>تدفع دالة <code>array_pop()‎</code> العنصر الأخير من المصفوفة <code>array</code> وتُعيد قيمته، وتقلل من طول المصفوفة <code>array</code> بمقدار عنصر واحد.
-ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة <code>[[PHP/Function/reset|reset()‎]]</code>.
+ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة <code>[[PHP/reset|reset()‎]]</code>.
 == المعاملات ==
@@ سطر 39: / سطر 39: @@
 == انظر أيضًا ==
-* الدالة <code>[[PHP/Function/array-push|array_push()]]</code>‎: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
+* الدالة <code>[[PHP/array_push|array_push()]]</code>‎: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
-* الدالة <code>[[PHP/Function/array-shift|array_shift()‎]]</code>: إزالة عنصر من بداية المصفوفة وإعادة قيمته.
+* الدالة <code>[[PHP/array_shift|array_shift()‎]]</code>: إزالة عنصر من بداية المصفوفة وإعادة قيمته.
-* الدالة <code>[[PHP/Function/array-unshift|array_unshift()‎]]</code>: إضافة عنصر واحد أو أكثر لبداية المصفوفة.
+* الدالة <code>[[PHP/array_unshift|array_unshift()‎]]</code>: إضافة عنصر واحد أو أكثر لبداية المصفوفة.
 == مصادر ==