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