array_diff_assoc

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

array_diff_assoc — Вычисляет расхождение массивов с дополнительной проверкой индекса

Описание

array_diff_assoc(array $array, array ...$arrays): array

Сравнивает значения массива array со значениями массивов arrays и возвращает разницу. В этой функции, в отличие от функции array_diff(), ключи массива также участвуют в сравнении.

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

array: Исходный массив
arrays: Массивы для сравнения

Возвращаемые значения

Возвращает массив (array), содержащий значения массива array, которых нет в других сравниваемых массивах.

Список изменений

Версия Описание

8.0.0 Функция теперь поддерживает вызов только с одним аргументом. Раньше требовалось не меньше двух аргументов.

Версия	Описание
8.0.0	Функция теперь поддерживает вызов только с одним аргументом. Раньше требовалось не меньше двух аргументов.

Примеры

Пример #1 Пример использования array_diff_assoc()

В этом примере пара "a" => "green" содержится в обоих массивах, и поэтому её нет в выводе функции. Но пара 0 => "red" содержится в выводе функции, потому что значению "red" в первом массиве автоматически присваивается ключ 0, а во втором массиве тому же значению будет присвоен ключ 1, поскольку ключ 0 уже занят значением yellow.

<?php
$array1 = array("a" => "green", "b" => "brown", "c" => "blue", "red");
$array2 = array("a" => "green", "yellow", "red");
$result = array_diff_assoc($array1, $array2);
print_r($result);
?>

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

Array
(
    [b] => brown
    [c] => blue
    [0] => red
)

Пример #2 Пример использования array_diff_assoc()

Два значения пар key => value будут расценены как равные только тогда, когда (string) $elem1 === (string) $elem2. То есть когда строковые представления значений при строгом сравнении будут тождествеными.

<?php
$array1 = array(0, 1, 2);
$array2 = array("00", "01", "2");
$result = array_diff_assoc($array1, $array2);
print_r($result);
?>

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

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

Примечания

Замечание: Эта функция проверяет только один уровень n-мерного массива. Сравнить вложенные массивы можно, указав более глубокий уровень, например: array_diff_assoc($array1[0], $array2[0]);.

Замечание: При сравнении аналогичных массивов, в которых много ключей, проверяют, чтобы аргументы передавались в правильном порядке. В массив с результатами попадают значения того массива, который идёт первым в списке аргументов.

Смотрите также

array_diff() - Вычисляет расхождение массивов
array_diff_uassoc() - Вычисляет расхождение массивов с дополнительной проверкой индекса через пользовательскую callback-функцию
array_udiff_assoc() - Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений callback-функцию
array_udiff_uassoc() - Вычисляет расхождение в массивах с дополнительной проверкой индексов, сравнивая значения и индексы через callback-функцию
array_intersect() - Вычисляет пересечение массивов
array_intersect_assoc() - Вычисляет пересечение массивов с дополнительной проверкой индекса