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 Теперь разрешается вызывать функцию только с одним параметром. Раньше требовалось не менее двух параметров.

Примеры

Пример #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() - Вычисляет пересечение массивов с дополнительной проверкой индекса