Documentación offline PHP master
/

array_diff

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

array_diff

Calcula la diferencia entre arrays

Descripción#

array_diff(array $array, array ...$arrays): array
```php

`array_diff` compara el array `array` con uno o más arrays y devuelve los valores del array `array` que no están presentes en los otros arrays.

## Parámetros

`array`  
El array desde el cual comparar

`arrays`  
Arrays a comparar

## Valores devueltos

Devuelve un `array` que contiene todas las entidades del array `array` que no están presentes en ninguno de los otros arrays. Las claves del array `array` son preservadas.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | Esta función puede ser llamada ahora con un solo parámetro. Anteriormente, al menos dos parámetros eran necesarios. |

## Ejemplos

Ejemplo con `array_diff`
"green", "red", "blue", "red"); $array2 = array("b" => "green", "yellow", "red"); $result = array_diff($array1, $array2); print_r($result); ?> 
Los valores múltiples en `array1` serán todos tratados de la misma forma. Esto mostrará:

    Array
    (
        [1] => blue
    )

Dos elementos son considerados iguales si y solo si `(string) $elem1 === (string) $elem2` ; es decir, cuando la [representación de string ](#language.types.string.casting) es la misma.

Ejemplo con la función `array_diff` con tipos que no coinciden
v = $v; } public function __toString() { return $this->v; } } $source = [new S('a'), new S('b'), new S('c')]; $filter = [new S('b'), new S('c'), new S('d')]; $result = array_diff($source, $filter); // $result ahora contiene una instancia de S('a'); var_dump($result); ?>

```php

Para utilizar una función de comparación alternativa, consulte la función array_udiff.

Notas#

[!NOTE] Tenga en cuenta que esta función solo verifica una dimensión de un array multidimensional. Por supuesto, se pueden verificar dimensiones más profundas utilizando array_diff($array1[0], $array2[0]);.

Véase también#

array_diff_assoc, array_udiff, array_intersect, array_intersect_assoc