(PHP 4, PHP 5, PHP 7, PHP 8)
array_unshift — Bir dizinin başlangıcına bir veya daha fazla eleman ekler
array_unshift() işlevi aktarılan elemanları array
dizisinin önüne ekler. Elemanlar diziye işleve aktarıldıkları sıra ile eklenirler. Sayısal anahtarlar sıfırdan başlayacak şekilde değiştirilir fakat sayısal olmayan anahtarlar değiştirilmez.
Bilginize:
Dahili dizi göstericisi ilk elemana atanır.
dizi
İşleme sokulacak dizi.
değerler
Başa eklenecek değerler.
Dizeye eklenen üye sayısı ile döner.
Sürüm: | Açıklama |
---|---|
7.3.0 | Bu işlev artık tek bağımsız değişken ile çağrılabiliyor. Evvelce, en az iki bağımsız değişken gerekirdi. |
Örnek 1 - array_unshift() örneği
<?php
$liste = [
"ayva",
"muz"
];
array_unshift($liste, "elma", "armut");
var_dump($liste);
?>
Yukarıdaki örneğin çıktısı:
array(4) { [0]=> string(4) "elma" [1]=> string(5) "armut" [2]=> string(4) "ayva" [3]=> string(3) "muz" }
Örnek 2 - İlişkisel dizilerle kullanım
Bir ilişkisel dizi başka bir ilişkisel dizinin başına eklenirse, başa eklenen dizi sayısal olarak diğer diziye indislenir.
<?php
$meyveler = [
'elmalar' => [
'Amasya' => 'kırmızı',
'Ekşi' => 'yeşil',
],
'portakallar' => [
'Finike' => 'turuncu',
'Vaşington' => 'turuncu',
],
];
$sebzeler = [
'hıyarlar' => [
'Çengelköy' => 'yeşil',
'Acur' => 'yeşil',
],
'havuçlar' => [
'Turuncu' => 'turuncu',
'Şalgam' => 'mor',
],
'marullar' => [
'Kıvırcık' => 'yeşil',
'Göbek' => 'yeşil',
],
];
array_unshift($meyveler, $sebzeler);
var_dump($meyveler);
Yukarıdaki örneğin çıktısı:
array(3) { [0]=> array(3) { ["hıyarlar"]=> array(2) { ["Çengelköy"]=> string(6) "yeşil" ["Acur"]=> string(6) "yeşil" } ["havuçlar"]=> array(2) { ["Turuncu"]=> string(7) "turuncu" ["Şalgam"]=> string(3) "mor" } ["marullar"]=> array(2) { ["Kıvırcık"]=> string(6) "yeşil" ["Göbek"]=> string(6) "yeşil" } } ["elmalar"]=> array(2) { ["Amasya"]=> string(10) "kırmızı" ["Ekşi"]=> string(6) "yeşil" } ["portakallar"]=> array(2) { ["Finike"]=> string(7) "turuncu" ["Vaşington"]=> string(7) "turuncu" } }