Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

array_unshift

Array-Funktionen

    Befehl:
int array_unshift ( array &$array, mixed $var [, mixed $...] )


    Parameter-Liste:
NameBeschreibung
arrayDas Eingabe-Array.
value1Erster Wert voranstellen.

    Rückgabewerte:
Liefert die neue Anzahl der Elemente in der array.

    Beschreibung:
Die Funktion array_unshift() fügt neue Elemente (var) am Anfang eines Arrays (array) ein. Die bereits vorhandenen Elemente werden nach hinten geschoben.

Vorhandene numerische Schlüssel in array werden ignoriert, sodass bei null begonnen wird. Strings als Schlüssel bleiben von dieser Funktion unberührt.

Als Rückgabewert dieser Fuktion erhalten Sie die Menge des modifizierten Arrays.


    Aktiv in Version:
(PHP 4, PHP 5, PHP 7)

    Siehe auch:
Liefert ein Element vom Beginn eines Arrays
 
Fügt ein oder mehr Elemente an das Ende eines Arrays
 
Liefert das letzte Element eines Arrays
 

array_unshift() - Beispiel:


Eingabe:
<?php
$queue = array("Orange", "Banane");
array_unshift($queue, "Apfel", "Himbeere");
?>


Ausgabe:
Array
(
    [0] => Apfel
    [1] => Himbeere
    [2] => Orange
    [3] => Banane
)
array_unshift() - Beispiel 2:


Eingabe:
<?PHP
$array1 = array ( 0 => 'php', 'sprache' => 'asp' );

$menge = array_unshift ( $array1, 'perl', 'c++' );

print_r ( $array1 );

echo $menge . ' Werte!';
?>


Ausgabe:
Array
(
    [0] => perl
    [1] => c++
    [2] => php
    [sprache] => asp
)
4 Werte!
Array-Funktionen