array_unshift

(PHP 4, PHP 5, PHP 7, PHP 8)

array_unshiftBir dizinin başlangıcına bir veya daha fazla eleman ekler

Açıklama

array_unshift(array&$dizi, mixed...$değerler): int

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.

Bağımsız Değişkenler

dizi

İşleme sokulacak dizi.

değerler

Başa eklenecek değerler.

Dönen Değerler

Dizeye eklenen üye sayısı ile döner.

Sürüm Bilgisi

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.

Örnekler

Ö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" } }

Ayrıca Bakınız

  • array_merge() - Belirtilen dizileri ardarda ekleyerek yeni bir dizi oluşturur
  • array_shift() - Dizini başlangıcından bir eleman çeker
  • array_push() - Belli sayıda elemanı dizinin sonuna ekler
  • array_pop() - Dizinin sonundaki elemanı diziden çıkartır
To Top