Funkcja PHP array_merge()

Funkcja PHP array_merge() łączy elementy z dowolnej liczby tablic w jedną tablicę w ten sposób, że dodaje elementy każdej tablicy na końcu poprzedniej.

Funkcji tej można przekazać tylko jedną tablicę i wówczas zwróci ona tę samą tablicę. A jeśli funkcja ta zostanie wywołana bez żadnego argumentu, to zwróci pustą tablicę.

Przykład

Scalenie dwóch tablic za pomocą funkcji PHP array_merge().


$a = ["a", "b", "c"];
$b = ["1", "2", "3"];

$c = array_merge($a, $b);

var_dump($c);

Po scaleniu tablic $a i $b za pomocą funkcji array_merge() powstaje nowa tablica, zawierająca elementy tablicy $b dołączone po elementach tablicy $a:

array(6) {
  [0]=>
  string(1) "a"
  [1]=>
  string(1) "b"
  [2]=>
  string(1) "c"
  [3]=>
  string(1) "1"
  [4]=>
  string(1) "2"
  [5]=>
  string(1) "3"
}

Składnia funkcji PHP array_merge()

Funkcja PHP array_merge() ma następującą składnię:

array_merge(array ...$arrays): array

Parametry

Parametr	Opis
`arrays`	Dowolna liczba rozdzielonych przecinkami tablic, które mają zostać scalone. Jeśli w scalanych tablicach występują takie same klucze łańcuchowe, to w tablicy wynikowej znajdzie się wartość tylko ostatniego z nich. Jeśli w scalanych tablicach występują takie same klucze liczbowe, to wartości wszystkich zostaną umieszczone w nowej tablicy, ale ich indeksy zostaną przeliczone, zaczynając od zera.

Parametr

Opis

arrays

Dowolna liczba rozdzielonych przecinkami tablic, które mają zostać scalone.

Jeśli w scalanych tablicach występują takie same klucze łańcuchowe, to w tablicy wynikowej znajdzie się wartość tylko ostatniego z nich.

Jeśli w scalanych tablicach występują takie same klucze liczbowe, to wartości wszystkich zostaną umieszczone w nowej tablicy, ale ich indeksy zostaną przeliczone, zaczynając od zera.

Wartość zwrotna

Funkcja PHP array_merge() zwraca tablicę zawierającą elementy scalanych tablic.

Typ zwrotny: array.

Dodatkowe przykłady

Scalanie tablic zawierających powtarzające się klucze różnego typu

W poniższym przykładzie funkcja array_merge() łączy trzy tablice, które zawierają częściowo pokrywające się klucze różnego typu:


$a = ["a", "drugi" => "b", "c"];
$b = ["1", "drugi" => "2", "3"];

$c = array_merge($a, $b);

var_dump($c);

Wynik:

array(5) {
  [0]=>
  string(1) "a"
  ["drugi"]=>
  string(1) "2"
  [1]=>
  string(1) "c"
  [2]=>
  string(1) "1"
  [3]=>
  string(1) "3"
}