عرض مصدر PHP/array shift

<noinclude>{{DISPLAYTITLE:<code>array_shift()‎</code>}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تُزيل الدالة <code>array_shift()</code>‎ عنصرًا من بداية المصفوفة وتُعيد قيمته.

== الوصف ==
<syntaxhighlight lang="php">
mixed array_shift ( array &$array )
</syntaxhighlight>تُزيل <code>array_shift()</code>‎ العنصر الأول من المصفوفة <code>array</code> وتعيد قيمته، مع تقصير المصفوفة <code>array</code> بمقدار عنصر واحد وإزاحة جميع العناصر نحو بداية المصفوفة. تُعدَّل جميع المفاتيح العددية للمصفوفة لبدء العد من الصفر بينما لا تتغير المفاتيح الحرفية.

ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة باستخدام الدالة <code>[[PHP/reset|()‎reset]]</code> بعد استعمالها.

== المعاملات ==

=== <code>array</code> ===
المصفوفة المُدخَلة.

== القيم المعادة ==
تعيد قيمة العنصر المحذوف، أو القيمة <code>NULL</code> إذا كانت المصفوفة <code>array</code> فارغةً (أو ليست مصفوفة).

== أمثلة ==
المثال 1: مثال على الدالة <code>array_shift()</code>‎<syntaxhighlight lang="php">
<?php
$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
Array
(
    [0] => banana
    [1] => apple
    [2] => raspberry
)
</syntaxhighlight>وستُسنَد القيمة <code>orange</code> إلى المتغير ‎<code>$fruit</code>.

== انظر أيضًا ==
* الدالة <code>[[PHP/array_unshift|array_unshift()]]</code>‎: إضافة عنصر واحد أو أكثر لبداية المصفوفة.
* الدالة <code>[[PHP/array_push|array_push()]]‎</code>: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
* الدالة <code>[[PHP/array_pop|array_pop()]]</code>‎: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.

== مصادر ==
* [http://php.net/manual/en/function.array-shift.php صفحة الدالة array_shift في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]