array_diff_ukey

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

array_diff_ukey — Calcula la diferencia entre dos arrays utilizando una función de retrollamada sobre las claves para comparación

Descripción

array_diff_ukey(array $array, array ...$arrays, callable $key_compare_func): array

Compara las claves del array array con las de los arrays arrays y devuelve la diferencia. Esta función es idéntica a la función array_diff(), excepto que la comparación se realiza sobre las claves, en lugar de sobre los valores.

A diferencia de la función array_diff_key(), se proporciona una función de usuario para la comparación de índices, y no una función interna.

Parámetros

array: El array a comparar
arrays: Arrays a comparar contra
key_compare_func: La función de comparación debe retornar un entero menor que, igual a, o mayor que 0 si el primer argumento es considerado, respectivamente, menor que, igual a, o mayor que el segundo.

callback(mixed $a, mixed $b): int

Precaución
Retornar valores no-entero desde la función de comparación, tales como float, resultará en una conversión interna del valor de retorno del callback a int. Así, valores tales como 0.99 y 0.1 serán convertidos ambos a un valor entero de 0, lo que comparará tales valores como iguales.

Valores devueltos

Devuelve un array que contiene todas las entradas del array array que no están presentes en ningún otro array.

Ejemplos

Ejemplo #1 Ejemplo con array_diff_ukey()

<?php
function key_compare_func($key1, $key2)
{
    if ($key1 == $key2)
        return 0;
    else if ($key1 > $key2)
        return 1;
    else
        return -1;
}

$array1 = array('blue'  => 1, 'red'  => 2, 'green'  => 3, 'purple' => 4);
$array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan'   => 8);

var_dump(array_diff_ukey($array1, $array2, 'key_compare_func'));
?>

El ejemplo anterior mostrará:

array(2) {
  ["red"]=>
  int(2)
  ["purple"]=>
  int(4)
}

Notas

Nota:
Se debe tener en cuenta que esta función verifica únicamente una dimensión de un array que posee n dimensiones. Por supuesto, se puede verificar una dimensión más profunda utilizando, por ejemplo, array_diff_ukey($array1[0], $array2[0], 'callback_func');.

Ver también

array_diff() - Calcula la diferencia entre arrays
array_udiff() - Calcula la diferencia entre dos arrays utilizando una función de retrollamada
array_diff_assoc() - Calcula la diferencia de dos arrays, teniendo en cuenta las claves
array_diff_uassoc() - Calcula la diferencia entre dos arrays asociativos, utilizando una función de retrollamada
array_udiff_assoc() - Calcula la diferencia entre arrays con verificación de índices, compara los datos con una función de retrollamada
array_udiff_uassoc() - Calcula la diferencia entre dos arrays asociativos, compara los datos y los índices con una función de retorno
array_diff_key() - Calcula la diferencia de dos arrays utilizando las claves para la comparación
array_intersect() - Calcula la intersección de arrays
array_intersect_assoc() - Calcula la intersección de dos arrays con pruebas sobre los índices
array_intersect_uassoc() - Calcula la intersección de dos arrays con pruebas en los índices, compara los índices utilizando una función de retrollamada
array_intersect_key() - Calcula la intersección de dos arrays utilizando las claves para la comparación
array_intersect_ukey() - Calcula la intersección de dos arrays utilizando una función de retrollamada sobre las claves para la comparación