array_pop()‎

من موسوعة حسوب
< PHP

(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()‎: إضافة عنصر واحد أو أكثر لبداية المصفوفة.

مصادر