Calcula la diferencia entre dos arrays utilizando una función de retrollamada

# array_udiff

(PHP 5, PHP 7, PHP 8)

array_udiff — Calcula la diferencia entre dos arrays utilizando una función de retrollamada

### Descripción

function array_udiff(array `$array`, array `...$arrays`, callable `$value_compare_func`): array

Calcula la diferencia entre dos arrays utilizando una función de retrollamada. Esta función actúa como la función array_diff() que utiliza una función interna para comparar los datos.

### Parámetros

`array`

  El primer array.

`arrays`

  Arrays a comparar contra

`value_compare_func`

  La función de comparación.

  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.
  function 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.

  Precaución

  La función de callback de ordenación debe tratar cualquier valor de cualquier array en cualquier orden, independientemente del orden en el que fueron proporcionados inicialmente. Esto se debe a que cada array individual es ordenado primero antes de ser comparado con otros arrays. Por ejemplo:

      <?php
      $arrayA = ["cadena", 1];
      $arrayB = [["value" => 1]];
      // $item1 y $item2 pueden ser cualquiera de los siguientes valores : "cadena", 1 o ["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;
      };
      ?>

### Valores devueltos

Retorna un array que contiene todas las valores del array `array` que no están presentes en ningún otro argumento.

### Ejemplos

Ejemplo #1 Ejemplo con array_udiff() utilizando objetos stdClass

    <?php
    // Arrays a comparar
    $array1 = array(new stdClass, new stdClass,
                    new stdClass, new stdClass,
                   );

    $array2 = array(
                    new stdClass, new stdClass,
                   );

    // Define algunas propiedades para cada objeto
    $array1[0]->width = 11; $array1[0]->height = 3;
    $array1[1]->width = 7;  $array1[1]->height = 1;
    $array1[2]->width = 2;  $array1[2]->height = 9;
    $array1[3]->width = 5;  $array1[3]->height = 7;

    $array2[0]->width = 7;  $array2[0]->height = 5;
    $array2[1]->width = 9;  $array2[1]->height = 2;

    function compare_by_area($a, $b) {
        $areaA = $a->width * $a->height;
        $areaB = $b->width * $b->height;

        if ($areaA < $areaB) {
            return -1;
        } elseif ($areaA > $areaB) {
            return 1;
        } else {
            return 0;
        }
    }

    print_r(array_udiff($array1, $array2, 'compare_by_area'));
    ?>

El ejemplo anterior mostrará:

    Array
    (
        [0] => stdClass Object
            (
                [width] => 11
                [height] => 3
            )

        [1] => stdClass Object
            (
                [width] => 7
                [height] => 1
            )

    )

Ejemplo #2 Ejemplo con array_udiff() utilizando objetos DateTime

    <?php
    class MyCalendar {
        public $free = array();
        public $booked = array();

        public function __construct($week = 'now') {
            $start = new DateTime($week);
            $start->modify('Monday this week midnight');
            $end = clone $start;
            $end->modify('Friday this week midnight');
            $interval = new DateInterval('P1D');
            foreach (new DatePeriod($start, $interval, $end) as $freeTime) {
                $this->free[] = $freeTime;
            }
        }

        public function bookAppointment(DateTime $date, $note) {
            $this->booked[] = array('date' => $date->modify('midnight'), 'note' => $note);
        }

        public function checkAvailability() {
            return array_udiff($this->free, $this->booked, array($this, 'customCompare'));
        }

        public function customCompare($free, $booked) {
            if (is_array($free)) $a = $free['date'];
            else $a = $free;
            if (is_array($booked)) $b = $booked['date'];
            else $b = $booked;
            if ($a == $b) {
                return 0;
            } elseif ($a > $b) {
                return 1;
            } else {
                return -1;
            }
        }
    }

    // Crea un calendario para las citas semanales
    $myCalendar = new MyCalendar;

    // Registra algunas citas para esta semana
    $myCalendar->bookAppointment(new DateTime('Monday this week'), "Limpiar el apartamento de GoogleGuy.");
    $myCalendar->bookAppointment(new DateTime('Wednesday this week'), "Ir a un viaje de snowboard.");
    $myCalendar->bookAppointment(new DateTime('Friday this week'), "Arreglar código con errores.");

    // Verifica la disponibilidad en días, comparando las fechas $booked con las fechas $free
    echo "Estoy disponible en los siguientes días esta semana...\n\n";
    foreach ($myCalendar->checkAvailability() as $free) {
        echo $free->format('l'), "\n";
    }
    echo "\n\n";
    echo "Estoy ocupado en los siguientes días esta semana...\n\n";
    foreach ($myCalendar->booked as $booked) {
        echo $booked['date']->format('l'), ": ", $booked['note'], "\n";
    }
    ?>

El ejemplo anterior mostrará:

    Estoy disponible en los siguientes días esta semana...

    Tuesday
    Thursday

    Estoy ocupado en los siguientes días esta semana...

    Monday: Limpiar el apartamento de GoogleGuy.
    Wednesday: Ir a un viaje de snowboard.
    Friday: Arreglar código con errores.

### Notas

> Nota: Tenga en cuenta que esta función solo verifica una dimensión de un array multidimensional. Por supuesto, se puede probar una dimensión particular utilizando, por ejemplo, `array_udiff($array1[0], $array2[0], "data_compare_func");`.

### Ver también

- array_diff() - Calcula la diferencia entre arrays
- 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_intersect() - Calcula la intersección de arrays
- array_intersect_assoc() - Calcula la intersección de dos arrays con pruebas sobre los índices
- array_uintersect() - Calcula la intersección de dos arrays, compara los datos utilizando una función de retrollamada
- array_uintersect_assoc() - Calcula la intersección de dos arrays con pruebas sobre el índice, compara los datos utilizando una función de retrollamada
- array_uintersect_uassoc() - Calcula la intersección de dos arrays con pruebas en el índice, compara los datos y los índices de los dos arrays utilizando una función de retrollamada separada

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open