Funkcja PHP array_replace_recursive() pobiera tablice przekazane jej jako argumenty i tworzy z nich nową tablicę, w której umieszcza po jednym elemencie dla każdego klucza z tych tablic źródłowych. Jeśli któryś klucz występuje w kilku tablicach, to ostatecznie zostaje użyty element z ostatniej z nich.
Funkcja array_replace_recursive() działa rekurencyjnie, czyli „wchodzi” także do tablic, w których wykonuje takie same działania.
Jeśli wartość pierwszej tablicy jest skalarna, to zostanie ona zastąpiona wartością z drugiej tablicy, niezależnie od tego, czy jest ona tablicą czy wartością skalarną.
Jeśli natomiast wartości pierwszej i drugiej tablicy są tablicami, to funkcja array_replace_recursive() rekurencyjnie dokona odpowiedniej zamiany zawartych w nich wartości.
Składnia funkcji PHP array_replace_recursive()
Funkcja PHP array_replace_recursive() ma następującą składnię:
array_replace(array $array, array ...$replacements): array
Parametry
| Parametr | Opis |
|---|---|
| array | Parametr obowiązkowy. Tablica, której elementy będą zastępowane. |
| replacements | Tablice, z których będą pobierane dalsze elementy do podmiany lub wstawienia do tablicy wynikowej. |
Wartość zwrotna
Funkcja PHP array_replace_recursive() zwraca nową tablicę zawierającą po jednym elemencie z każdym kluczem występującym w tablicach źródłowych. Jeśli któryś klucz występował w więcej niż jednej tablicy, to w tablicy wynikowej znalazł się tylko ten z ostatniej z nich.
Typ zwrotny: array.
