array_unshift()‎

(PHP 4, PHP 5, PHP 7)

تضيف الدالة array_unshift()‎ عنصرًا واحدًا أو أكثر لبداية المصفوفة.

الوصف

int array_unshift ( array &$array , mixed $value1 [, mixed $... ] )

تضيف الدالة array_unshift()‎ العناصر المُدخلة إلى بداية المصفوفة array. لاحظ أنَّ قائمة العناصر تدخل في بداية المصفوفة دفعةً واحدة، بحيث تبقى العناصر المُدخلة في الترتيب نفسه. ستُعدّل جميع مفاتيح المصفوفة العددية لتبدأ العد من الصفر في حين أن المفاتيح الحرفية لن تتغير.

المعاملات

array

المصفوفة المُدخلة.

value1

القيمة الأولى المراد إدخالها في بداية المصفوفة.

القيم المعادة

تُعيد الدالة ()‎array_unshift عدد العناصر الجديد في المصفوفة.

أمثلة

المثال 1: مثال على الدالة array_unshift()‎

<?php
$queue = array("orange", "banana");
array_unshift($queue, "apple", "raspberry");
print_r($queue);
?>

سوف تكون مُخرجات المثال أعلاه كالتالي:

Array
(
    [0] => apple
    [1] => raspberry
    [2] => orange
    [3] => banana
)

انظر أيضًا

• الدالة array_shift()‎: إزالة عنصر من بداية المصفوفة وإعادة قيمته.
• الدالة array_push()‎: إضافة عنصر واحد أو أكثر في نهاية المصفوفة.
• الدالة array_pop()‎: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.

مصادر

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