array_merge

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

array_merge - Зливає один або більше масивів

Опис

array_merge(array ...$arrays): array

Зливає елементи одного або більшої кількості масивів таким чином, що значення одного масиву приєднуються до кінця попереднього. Результатом роботи функції є новий масив.

Якщо вхідні масиви мають однакові рядкові ключі, то кожне наступне значення буде замінювати попереднє. Однак, якщо масиви мають однакові числові ключі, значення, згадане останнім, не замінить вихідне значення, а буде додано до кінця масиву.

У результуючому масиві значення вихідного масиву з числовими ключами будуть перенумеровані у порядку, починаючи з нуля.

Список параметрів

arrays

Зливаються масиви.

Значення, що повертаються

Повертає результуючий масив. Якщо викликається без аргументів, вертає порожній масив (array).

список змін

Версия	Опис
7.4.0	Функцію тепер можна викликати без будь-яких параметрів. Раніше був потрібний хоча б один параметр.

Приклади

Приклад #1 Приклад використання array_merge()****

Loading...
▶

Результат виконання наведеного прикладу:

Array
(
    [color] => green
    [0] => 2
    [1] => 4
    [2] => a
    [3] => b
    [shape] => trapezoid
    [4] => 4
)

Приклад #2 Простий приклад використання array_merge()

Loading...
▶

Пам'ятайте, що числові ключі будуть перенумеровані!

Array
(
    [0] => data
)

Якщо ви бажаєте доповнити перший масив елементами другого без перезапису елементів першого масиву та без переіндексації, використовуйте оператор об'єднання масивів + :

Loading...
▶

Ключі з першого масиву буде збережено. Якщо ключ масиву існує в обох масивах, то буде використаний елемент першого масиву, а відповідний елемент другого масиву буде проігнорований.

array(5) {
  [0]=>
  string(6) "zero_a"
  [2]=>
  string(5) "two_a"
  [3]=>
  string(7) "three_a"
  [1]=>
  string(5) "one_b"
  [4]=>
  string(6) "four_b"
}

Приклад #3 Приклад використання array_merge()** з не масивами**

Loading...
▶

Результат виконання наведеного прикладу:

Array
    (
        [0] => foo
        [1] => bar
    )

Дивіться також

• array_merge_recursive() - Рекурсивне злиття одного або більше масивів
• array_replace() - Замінює елементи масиву елементами інших переданих масивів
• array_combine() - Створює новий масив, використовуючи один масив як ключі, а інший для його значень
• Оператори, що працюють із масивами