الفرق بين المراجعتين لصفحة: «PHP/array pop»
< PHP
ط إزالة سطر فارغ |
ط استبدال النص - 'PHP/Errors' ب'PHP/errors' |
||
| سطر 20: | سطر 20: | ||
== الأخطاء والاستثناءات == | == الأخطاء والاستثناءات == | ||
ستنتج هذه الدالة خطأً من المستوى <code>[[PHP/ | ستنتج هذه الدالة خطأً من المستوى <code>[[PHP/errors/errorfunc.constants|E_WARNING]]</code> عند استعمالها على قيمةٍ لا تمثِّل مصفوفةً. | ||
== أمثلة == | == أمثلة == | ||
مراجعة 03:30، 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(): إضافة عنصر واحد أو أكثر لبداية المصفوفة.