array_pop()
< PHP
(بالتحويل من PHP/Function/array-pop)(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()
: إضافة عنصر واحد أو أكثر لبداية المصفوفة.