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