Dominando la función PHP array_uintersect_uassoc

PHP es un lenguaje potente con diversas funciones, y array_uintersect_uassoc es una de las más versátiles de la librería de funciones de array de PHP. Esta función te permite calcular la intersección de arrays con funciones de comparación de claves definidas por el usuario.

Si buscas una forma de comparar dos arrays y obtener los valores que existen en todos ellos, la función array_uintersect_uassoc es lo que necesitas. Esta función ofrece la flexibilidad de comparar arrays con funciones de comparación personalizadas, lo que la convierte en una herramienta valiosa para cualquier desarrollador PHP.

A continuación se presenta una descripción detallada de la función array_uintersect_uassoc, junto con algunos ejemplos para ayudarte a entender cómo funciona.

¿Qué es la función array_uintersect_uassoc?

La función array_uintersect_uassoc es una función integrada de PHP que se utiliza para calcular la intersección de arrays mediante funciones de comparación definidas por el usuario para datos y claves. Esta función compara los valores de dos arrays y devuelve los valores que existen en todos ellos, siempre que sus claves también coincidan según la función de comparación de claves.

Una de las características clave de la función array_uintersect_uassoc es su capacidad para comparar arrays usando funciones de comparación de claves y valores definidas por el usuario. Esto significa que puedes personalizar la lógica de comparación para adaptarla a tus necesidades específicas.

Cómo usar la función array_uintersect_uassoc

La función array_uintersect_uassoc acepta dos o más arrays seguidos de dos callbacks — el último argumento es siempre el callback de comparación de claves, y el anterior es el callback de comparación de valores. Esta es la sintaxis:

Sintaxis de la función PHP array_uintersect_uassoc

array_uintersect_uassoc(
    array $array1,
    array $array2,
    array ...$arrays,
    callable $value_compare_func,
    callable $key_compare_func
): array

Parámetros:

array1: El array base. Los valores que superan la comparación se toman de aquí, conservando sus claves originales.
array2, ...$arrays: Uno o más arrays para comparar contra array1.
value_compare_func: Un callback para comparar valores. Recibe dos valores y debe devolver un entero menor que, igual a, o mayor que 0 — exactamente como un comparador de ordenamiento. Devolver 0 significa "iguales".
key_compare_func: Un callback para comparar claves, con el mismo contrato de retorno en tres sentidos.

Valor de retorno: Devuelve un array que contiene cada entrada de array1 cuyo valor y clave coincidan con una entrada en cada uno de los otros arrays. Un elemento sobrevive solo cuando ambos callbacks devuelven 0 contra algún elemento en cada uno de los otros arrays.

Dado que ambos callbacks siguen el contrato estándar <=> (spaceship), devolver 1 o -1 simplemente le indica a PHP que los elementos no son iguales — solo 0 cuenta como coincidencia.

Veamos un ejemplo de cómo usar la función array_uintersect_uassoc para comparar dos arrays:

PHP: Usar la función array_uintersect_uassoc para comparar dos arrays

<?php

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

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

$array1 = ["a" => "green", "b" => "brown", "c" => "blue", "d" => "red"];
$array2 = ["a" => "green", "b" => "yellow", "blue", "d" => "red"];

$result = array_uintersect_uassoc($array1, $array2, "compare_data", "compare_keys");
print_r($result);

?>

Pruébalo tú mismo »

En el ejemplo anterior, primero definimos dos funciones de comparación personalizadas para datos y claves, y luego definimos dos arrays que queremos comparar. Después llamamos a la función array_uintersect_uassoc con los dos arrays y las dos funciones de comparación como argumentos.

La función array_uintersect_uassoc devuelve un array que contiene los valores que existen en ambos arrays. En este ejemplo, el resultado sería:

Array
(
    [a] => green
    [d] => red
)

¿Por qué solo a y d? Un elemento sobrevive solo cuando tanto su clave como su valor coinciden.

[a] => green coincide: la clave a y el valor green existen en ambos arrays. Se conserva.
[b] => brown se descarta: la clave b existe en ambos, pero los valores (brown vs yellow) difieren.
[c] => blue se descarta: array1 lo tiene bajo la clave c, pero array2 almacena blue bajo la clave numérica asignada automáticamente 0, por lo que las claves no coinciden.
[d] => red coincide: la clave d y el valor red existen en ambos. Se conserva.

Ese último caso es exactamente lo que diferencia esta función de la intersección solo por valor: incluso cuando un valor está presente en ambos arrays, una clave que no coincide lo elimina.

Nota: El ejemplo usa funciones con nombre para amplia compatibilidad, pero PHP moderno (7.4+) admite funciones flecha concisas (por ejemplo, fn($a, $b) => $a <=> $b). Elige la sintaxis que se alinee con los requisitos de versión de PHP de tu proyecto.

Cuándo usar esta función

Usa array_uintersect_uassoc cuando las tres condiciones sean verdaderas: necesitas una intersección, las claves son significativas (datos asociativos), y tanto los valores como las claves requieren lógica de comparación personalizada (cadenas sin distinción de mayúsculas/minúsculas, objetos, ordenamiento según configuración regional, tolerancia en flotantes, etc.). Si solo necesitas una de ellas, una alternativa más simple es una mejor opción:

array_intersect — solo valores, comparación integrada.
array_intersect_assoc — clave y valor, comparación integrada.
array_uintersect — solo valores, callback de valor personalizado.
array_uintersect_assoc — callback de valor personalizado, comparación de clave integrada.
array_intersect_uassoc — comparación de valor integrada, callback de clave personalizado.

Consulta el capítulo PHP Arrays para una visión más amplia del trabajo con arrays.

Un ejemplo del mundo real: coincidencia sin distinción de mayúsculas/minúsculas

El primer ejemplo usó comparadores estrictos, por lo que se comporta como el array_intersect_assoc integrado. El verdadero poder aparece cuando los callbacks hacen algo que las funciones integradas no pueden — en este caso, hacer coincidir claves y valores independientemente de las mayúsculas/minúsculas:

<?php

$inventory = ["Apple" => "RED", "Banana" => "yellow", "Cherry" => "dark-red"];
$catalog   = ["apple" => "red", "banana" => "GREEN", "cherry" => "DARK-RED"];

$result = array_uintersect_uassoc(
    $inventory,
    $catalog,
    fn($a, $b) => strcasecmp($a, $b), // compare values, ignoring case
    fn($a, $b) => strcasecmp($a, $b)  // compare keys, ignoring case
);

print_r($result);

?>

strcasecmp devuelve 0 cuando dos cadenas son iguales sin distinguir mayúsculas/minúsculas, por lo que encaja perfectamente en el contrato del comparador. El resultado conserva las entradas de $inventory cuya clave y valor coinciden con $catalog sin distinción de mayúsculas/minúsculas:

Array
(
    [Apple] => RED
    [Cherry] => dark-red
)

Banana se excluye porque, aunque las claves coinciden, los valores (yellow vs GREEN) difieren incluso ignorando las mayúsculas/minúsculas. Un array_intersect_assoc simple no habría encontrado ninguna coincidencia, porque su comparación integrada distingue entre mayúsculas y minúsculas.

Ventajas de usar la función array_uintersect_uassoc

Hay varias ventajas en el uso de la función array_uintersect_uassoc en tus proyectos PHP. A continuación se presentan algunas de las principales ventajas:

1. Coincidencia precisa de clave-valor

A diferencia de array_uintersect, esta función garantiza que solo se devuelvan los elementos con claves y valores coincidentes. Esto evita falsos positivos al comparar arrays asociativos donde las claves tienen significado semántico.

2. Lógica de comparación personalizada

Puedes definir reglas de igualdad precisas tanto para valores como para claves, manejando tipos de datos complejos o requisitos de ordenamiento personalizados que los operadores integrados no pueden cubrir.

3. Rendimiento nativo

Implementada en C dentro del núcleo de PHP, se ejecuta de manera eficiente para operaciones estándar de array sin dependencias externas, lo que la hace adecuada para conjuntos de datos de tamaño moderado.

Consejos para usar la función array_uintersect_uassoc

A continuación se presentan algunos consejos para usar la función array_uintersect_uassoc en tus proyectos PHP:

1. Define funciones de comparación personalizadas

Para aprovechar al máximo la función array_uintersect_uassoc, es esencial definir funciones de comparación personalizadas. Esto te permitirá personalizar la lógica de comparación para adaptarla a las necesidades específicas de tu proyecto.

2. Usa comparación con seguridad de tipos

Al definir tus funciones de comparación personalizadas, es importante usar operadores de comparación con seguridad de tipos. Esto garantizará que la comparación se realice con los tipos de datos correctos, lo que mejorará la precisión de los resultados.

3. Prueba tus funciones de comparación

Antes de usar tus funciones de comparación personalizadas en producción, es importante probarlas exhaustivamente. Esto te ayudará a identificar errores o problemas y a asegurarte de que tu lógica de comparación funciona correctamente.

Conclusión

En este artículo, hemos explorado la función array_uintersect_uassoc en PHP. Esta función es una herramienta poderosa para comparar arrays y encontrar los valores que existen en todos ellos. Al usar funciones de comparación personalizadas para datos y claves, puedes personalizar la lógica de comparación para adaptarla a las necesidades específicas de tu proyecto.

Si quieres llevar tus habilidades en PHP al siguiente nivel, dominar la función array_uintersect_uassoc es un excelente punto de partida. Con su flexibilidad y versatilidad, esta función es una herramienta esencial para cualquier desarrollador PHP.

Gracias por leer nuestra guía sobre la función array_uintersect_uassoc. Esperamos que la hayas encontrado útil e informativa. Si tienes alguna pregunta o comentario, no dudes en contactarnos.

Práctica

¿Cuál es el propósito de la función array_uintersect_uassoc en PHP?

Comprueba si todos los valores del array existen en otro arrayCalcula la intersección de arrays con verificación de índice adicional usando una función de callback para la comparaciónOrdena un array usando una función de comparación definida por el usuarioMueve el puntero interno de un array al siguiente elemento