(PHP 4, PHP 5, PHP 7, PHP 8)
array_merge — Belirtilen dizileri ardarda ekleyerek yeni bir dizi oluşturur
Belirtilen dizilerin elemanlarını bir öncekinin elemanlarının ardına eklemek suretiyle yeni bir dizi oluşturur ve bu diziyi döndürür.
Eğer dizilerde aynı anahtara sahip elemanlar varsa sonraki dizinin elemanı öncekinin yerine konur. Ancak, eğer diziler sayısal anahtarlar içeriyorsa sonraki değer öncekinin üzerine yazılmaz, sona eklenir.
Belirtilen diziler sayısal indisli ise sonuç dizisindeki indisler sıfırdan başlayarak yeniden oluşturulur.
dizilerKatıştırılacak dizilerin değişken listesi.
Elde edilen diziyi döndürür. Bağımsız değişkensiz çağrılmışsa boş bir dizi döndürür.
| Sürüm: | Açıklama |
|---|---|
| 7.4.0 | Bu işlev bağımsız değişkensiz çağrılabilir. Evvelce, en azından bir bağımsız değişken gerekirdi. |
Örnek 1 - array_merge() örneği
<?php
$array1 = array("color" => "red", 2, 4);
$array2 = array("a", "b", "color" => "green", "shape" => "trapezoid", 4);
$result = array_merge($array1, $array2);
print_r($result);
?>Yukarıdaki örneğin çıktısı:
Array ( [color] => green [0] => 2 [1] => 4 [2] => a [3] => b [shape] => trapezoid [4] => 4 )
Örnek 2 - Basit array_merge() örneği
<?php
$dizi1 = array();
$dizi2 = array(1 => "veri");
$sonuç = array_merge($dizi1, $dizi2);
?>Sayısal anahtarların yeniden numaralanacağını unutmayın!
Array ( [0] => veri )
İkinci dizideki elemanlar birinci diziye eklerken sirinci dizideki elemanların üzerine yazılmaması ve yeniden indislenmemesi için + (dizi birleştirme) işlecini kullanın:
<?php
$dizi1 = array(0 => 'sıfır_a', 2 => 'iki_a', 3 => 'üç_a');
$dizi2 = array(1 => 'bir_b', 3 => 'üç_b', 4 => 'dört_b');
$sonuç = $dizi1 + $dizi2;
var_dump($sonuç);
?>Birinci dizideki anahtarlar korunur. Bir anahtar iki dizide de mevcutsa birincisi kullanılır ikinci dizideki yok sayılır.
array(5) { [0]=> string(9) "sıfır_a" [2]=> string(5) "iki_a" [3]=> string(6) "üç_a" [1]=> string(5) "bir_b" [4]=> string(7) "dört_b" }Örnek 3 - array türünde olmayan dizilerle array_merge()
<?php
$ilk = 'foo';
$son = array(1 => 'bar');
$sonuc = array_merge((array)$ilk, (array)$son);
print_r($sonuc);
?>Yukarıdaki örneğin çıktısı:
Array ( [0] => foo [1] => bar )