Edit Report a Bug

    array_uintersect

    (PHP 5, PHP 7, PHP 8)

    array_uintersect — Ermittelt die Schnittmenge von Arrays, vergleicht Daten mittels einer Callbackfunktion

    Beschreibung

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

    Ermittelt die Schnittmenge von Arrays, vergleicht Daten mittels einer Callbackfunktion.

    Parameter-Liste

    array

    Das erste Array.

    arrays

    Arrays zum Vergleichen.

    value_compare_func

    Die Vergleichsfunktion muss einen Integer kleiner als, gleich oder größer als Null zurückgeben, wenn das erste Argument respektive kleiner, gleich oder größer als das zweite ist.

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

    Wenn die Vergleichsfunktion nicht-ganzzahlige Werte zurückgibt, z. B. vom Typ float, wird der Rückgabewert des Callbacks intern in den Typ int umgewandelt. Werte wie 0.99 und 0.1 werden also beide in einen Integer-Wert von 0 umgewandelt, wodurch diese Werte als gleichwertig eingestuft werden.

    Achtung

    Das Sortier-Callback muss alle Werte aus allen Arrays in beliebiger Reihenfolge verarbeiten, unabhängig von der Reihenfolge, in der sie ursprünglich bereitgestellt wurden. Das liegt daran, dass jedes einzelne Array zuerst sortiert wird, bevor es mit anderen Arrays verglichen wird. Zum Beispiel:

    <?php
    $arrayA     = ["string", 1];
    $arrayB = [["value" => 1]];
    // $item1 und $item2 können "string", 1 oder ["value" => 1] sein.
    $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;
    };
    ?>

    Rückgabewerte

    Gibt ein Array mit allen Werten aus array zurück, die ebenfalls in allen anderen Argumenten enthalten sind.

    Beispiele

    Beispiel #1 array_uintersect() Beispiel

    <?php
    $array1     = array("a" => "grün", "b" => "braun", "c" => "blau", "rot");
    $array2 = array("a" => "GRÜN", "B" => "braun", "gelb", "rot");

    print_r(array_uintersect($array1, $array2, "strcasecmp"));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    Array
(
    [a] => grün
    [b] => braun
    [0] => rot
)

    Siehe auch

    • array_intersect() - Ermittelt die Schnittmenge von Arrays
    • array_intersect_assoc() - Ermittelt die Schnittmenge von Arrays mit zusätzlicher Indexprüfung
    • array_uintersect_assoc() - Ermittelt die Schnittmenge von Arrays mit zusätzlicher Indexprüfung, vergleicht Daten mittels einer Callbackfunktion
    • array_uintersect_uassoc() - Ermittelt die Schnittmenge von Arrays mit zusätzlicher Indexprüfung, vergleicht Daten und Schlüssel mittels separaten Callbackfunktionen

    add a note add a note

    User Contributed Notes 4 notes

    up
    14
    Nate at RuggFamily dot com
    17 years ago
    I want to stress that in the user function, you do need to return either a 1 or a -1 properly; you cannot simply return 0 if the results are equal and 1 if they are not. 

    The following code is incorrect:

    <?php
    function myfunction($v1,$v2)
    {
    if (    $v1===$v2)
        {
        return     0;
        }
    return     1;
    }

    $a1=array(1, 2, 4);
    $a2=array(1, 3, 4);
    print_r(array_uintersect($a1,$a2,"myfunction"));
    ?>

    This code is correct:

    <?php
    function myfunction($v1,$v2)
    {
    if (    $v1===$v2)
        {
        return     0;
        }
    if (    $v1 > $v2) return 1;
    return -    1;
    }
    $a1=array(1, 2, 4);
    $a2=array(1, 3, 4);
    print_r(array_uintersect($a1,$a2,"myfunction"));
    ?>
    up
    1
    rob dot c dot ruiz at gmail dot com
    6 years ago
    When trying to do a case insensitive comparison between arrays of words, the strcasecmp function works very nicely with this one like so:

    $arr1 = array('blue', 'green', 'red');

    $arr2 = array('BLUE', 'Purple', 'Red');

    $loose_matches = array_uintersect($arr1, $arr2, 'strcasecmp');

    print_r($loose_matches) // array('blue', 'red');
    up
    1
    Hayley Watson
    6 years ago
    As for the other "compare function" callbacks, the return value from the callback function doesn't need to be -1, 0, or 1.

    cmp($a,$b) just needs to be <0, =0, or >0 depending on whether $a<$b, $a=$b, or $a>$b.
    up
    1
    Ryan C
    2 years ago
    If you're rolling your own comparison function, keep in mind that the spaceship operator (i.e. <=>) can be your best friend. It's been around since PHP7. https://www.php.net/manual/en/language.operators.comparison.php

    So, for instance, instead of a clunky function like:

    <?php
    function myFunction($v1, $v2) {
       if (    $v1 === $v2) {
          return     0;
       }
       if (    $v1 > $v2) return 1;
       return -    1;
    }
    ?>

    You can simplify it to:

    <?php
    function myFunction($v1, $v2) {
       return     $v1 <=> $v2;
    }
    ?>
    add a note add a note
    To Top