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