Funktion array_unshift

Die Funktion array_unshift fügt Elemente am Anfang eines Arrays hinzu. Dabei wird das übergebene Array verändert, und die Funktion gibt die neue Anzahl der Elemente im Array zurück. Die hinzuzufügenden Elemente werden durch Kommas getrennt aufgelistet.

Syntax

phparray_unshift(array &$array, mixed ...$values): int

Beispiel

Fügen wir dem Array am Anfang noch 2 Elemente hinzu:

php<?php
  $arr = [1, 2, 3, 4, 5];
  
  $num = array_unshift($arr, 'a', 'b');
  var_dump($arr);
?>

Das Ergebnis der Codeausführung:

php['a', 'b', 1, 2, 3, 4, 5]

In der Variable $num befindet sich die neue Anzahl der Array-Elemente:

php7

Siehe auch

  • die Funktion array_shift,
    die das erste Element eines Arrays ausliest und entfernt