الفرق بين المراجعتين لصفحة: «PHP/array pop»
< PHP
ط استبدال النص - 'PHP/Function/array' ب'PHP/array' |
ط استبدال النص - 'PHP\/Function\/([^|]*)' ب'PHP/$1' |
||
| سطر 9: | سطر 9: | ||
</syntaxhighlight>تدفع دالة <code>array_pop()</code> العنصر الأخير من المصفوفة <code>array</code> وتُعيد قيمته، وتقلل من طول المصفوفة <code>array</code> بمقدار عنصر واحد. | </syntaxhighlight>تدفع دالة <code>array_pop()</code> العنصر الأخير من المصفوفة <code>array</code> وتُعيد قيمته، وتقلل من طول المصفوفة <code>array</code> بمقدار عنصر واحد. | ||
ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة <code>[[PHP | ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة <code>[[PHP/reset|reset()]]</code>. | ||
== المعاملات == | == المعاملات == | ||
مراجعة 03:42، 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(): إضافة عنصر واحد أو أكثر لبداية المصفوفة.