الفرق بين المراجعتين ل"PHP/array shift"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
ط (استبدال النص - 'PHP/Function/array' ب'PHP/array') |
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/array-shift إلى PHP/array shift: إعادة هيكلة التوثيق) |
||
| (مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين) | |||
| سطر 9: | سطر 9: | ||
</syntaxhighlight>تُزيل <code>array_shift()</code> العنصر الأول من المصفوفة <code>array</code> وتعيد قيمته، مع تقصير المصفوفة <code>array</code> بمقدار عنصر واحد وإزاحة جميع العناصر نحو بداية المصفوفة. تُعدَّل جميع المفاتيح العددية للمصفوفة لبدء العد من الصفر بينما لا تتغير المفاتيح الحرفية. | </syntaxhighlight>تُزيل <code>array_shift()</code> العنصر الأول من المصفوفة <code>array</code> وتعيد قيمته، مع تقصير المصفوفة <code>array</code> بمقدار عنصر واحد وإزاحة جميع العناصر نحو بداية المصفوفة. تُعدَّل جميع المفاتيح العددية للمصفوفة لبدء العد من الصفر بينما لا تتغير المفاتيح الحرفية. | ||
| − | ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة باستخدام الدالة <code>[[PHP | + | ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة باستخدام الدالة <code>[[PHP/reset|()reset]]</code> بعد استعمالها. |
== المعاملات == | == المعاملات == | ||
| سطر 36: | سطر 36: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/array_unshift|array_unshift()]]</code>: إضافة عنصر واحد أو أكثر لبداية المصفوفة. |
| − | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/array_push|array_push()]]</code>: إضافة عنصر واحد أو أكثر في نهاية المصفوفة. |
| − | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/array_pop|array_pop()]]</code>: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته. |
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تُزيل الدالة array_shift() عنصرًا من بداية المصفوفة وتُعيد قيمته.
الوصف
mixed array_shift ( array &$array )
تُزيل array_shift() العنصر الأول من المصفوفة array وتعيد قيمته، مع تقصير المصفوفة array بمقدار عنصر واحد وإزاحة جميع العناصر نحو بداية المصفوفة. تُعدَّل جميع المفاتيح العددية للمصفوفة لبدء العد من الصفر بينما لا تتغير المفاتيح الحرفية.
ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة باستخدام الدالة ()reset بعد استعمالها.
المعاملات
array
المصفوفة المُدخَلة.
القيم المعادة
تعيد قيمة العنصر المحذوف، أو القيمة NULL إذا كانت المصفوفة array فارغةً (أو ليست مصفوفة).
أمثلة
المثال 1: مثال على الدالة array_shift()
<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>
سوف تكون مُخرجات المثال أعلاه كالتالي:
Array
(
[0] => banana
[1] => apple
[2] => raspberry
)
وستُسنَد القيمة orange إلى المتغير $fruit.
انظر أيضًا
- الدالة
array_unshift(): إضافة عنصر واحد أو أكثر لبداية المصفوفة. - الدالة
array_push(): إضافة عنصر واحد أو أكثر في نهاية المصفوفة. - الدالة
array_pop(): إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.