الفرق بين المراجعتين لصفحة: «PHP/array shift»

المراجعة الحالية بتاريخ 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()‎: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.

مصادر

صفحة الدالة array_shift في توثيق PHP الرسمي.

@@ سطر 9: / سطر 9: @@
 </syntaxhighlight>تُزيل <code>array_shift()</code>‎ العنصر الأول من المصفوفة <code>array</code> وتعيد قيمته، مع تقصير المصفوفة <code>array</code> بمقدار عنصر واحد وإزاحة جميع العناصر نحو بداية المصفوفة. تُعدَّل جميع المفاتيح العددية للمصفوفة لبدء العد من الصفر بينما لا تتغير المفاتيح الحرفية.
-ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة باستخدام الدالة <code>[[PHP/Function/reset|()‎reset]]</code> بعد استعمالها.
+ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة باستخدام الدالة <code>[[PHP/reset|()‎reset]]</code> بعد استعمالها.
 == المعاملات ==
@@ سطر 36: / سطر 36: @@
 == انظر أيضًا ==
-* الدالة <code>[[PHP/Function/array-unshift|array_unshift()]]</code>‎: إضافة عنصر واحد أو أكثر لبداية المصفوفة.
+* الدالة <code>[[PHP/array_unshift|array_unshift()]]</code>‎: إضافة عنصر واحد أو أكثر لبداية المصفوفة.
-* الدالة <code>[[PHP/Function/array-push|array_push()]]‎</code>: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
+* الدالة <code>[[PHP/array_push|array_push()]]‎</code>: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
-* الدالة <code>[[PHP/Function/array-pop|array_pop()]]</code>‎: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.
+* الدالة <code>[[PHP/array_pop|array_pop()]]</code>‎: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.
 == مصادر ==