array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.array-udiff-assoc.php', 1 => 'array_udiff_assoc', 2 => 'Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений callback-функцию', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.array-udiff.php', 1 => 'array_udiff', ), 'next' => array ( 0 => 'function.array-udiff-uassoc.php', 1 => 'array_udiff_uassoc', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/array-udiff-assoc.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_udiff_assoc

(PHP 5, PHP 7, PHP 8)

array_udiff_assoc — Вычисляет расхождение в массивах с дополнительной проверкой индексов, используя для сравнения значений callback-функцию

Описание

array_udiff_assoc(array $array, array ...$arrays, callable $value_compare_func): array

Вычисляет расхождение массивов с дополнительной проверкой индексов, используя для сравнения значений callback-функцию.

Замечание: Обратите внимание, что функция обрабатывает только первый уровень многомерного массива. Значения на вложенных уровнях обрабатывают, например, так: array_udiff_assoc($array1[0], $array2[0], "some_comparison_func");.

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

array

Первый массив.

arrays

Массивы для сравнения.

value_compare_func

Функция сравнения должна возвращать целое, которое меньше, равно или больше нуля, если первый аргумент является соответственно меньшим, равным или большим, чем второй.

callback(mixed $a, mixed $b): int
Предостережение

При возврате из функции сравнения нецелых значений наподобие float PHP внутренне приведёт значение, которое возвращает callback-функции, к типу int. Поэтому значения наподобие 0.99 и 0.1 приводятся к целочисленному значению 0 и сравниваются как равные.

Предостережение

Callback-функция сортировки должна обрабатывать любое значение из любого массива в любом порядке независимо от первоначального порядка. Причина состоит в том, что каждый отдельный массив вначале сортируется, а затем сравнивается с другими массивами. Например:

<?php

$arrayA = ["string", 1];
$arrayB = [["value" => 1]];

// В переменных $item1 и $item2 возможны значения "string", 1 или ["value" => 1]
$compareFunc = static function ($item1, $item2) {
$value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
$value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
return $value1 <=> $value2;
};

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

Функция array_udiff_assoc() возвращает массив (array), содержащий элементы аргумента array, которых нет ни в одном другом аргументе. Обратите внимание, что в отличие от функций array_diff() и array_udiff() при сравнении значений также сравниваются и ключи. Значения массива сравнивает заданная пользователем callback-функция. В этой части поведение функции отличается от поведения функции array_diff_assoc(), которая для сравнения работает со встроенной функцией.

Примеры

Пример #1 Пример использования функции array_udiff_assoc()

<?php

class cr {
private $priv_member;
function __construct($val)
{
$this->priv_member = $val;
}

static function comp_func_cr($a, $b)
{
if ($a->priv_member === $b->priv_member) return 0;
return ($a->priv_member > $b->priv_member)? 1:-1;
}
}

$a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
$b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);

$result = array_udiff_assoc($a, $b, array("cr", "comp_func_cr"));
print_r($result);

?>

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

Array
(
    [0.1] => cr Object
        (
            [priv_member:private] => 9
        )

    [0.5] => cr Object
        (
            [priv_member:private] => 12
        )

    [0] => cr Object
        (
            [priv_member:private] => 23
        )
)

В приведённом примере видно, что пара "1" => new cr(4) есть в обоих массивах, и поэтому её нет в выводе функции.

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