Edit Report a Bug

    array_uintersect

    (PHP 5, PHP 7, PHP 8)

    array_uintersect — Calcule l'intersection de deux tableaux, compare les données en utilisant une fonction de rappel

    Description

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

    Calcule l'intersection de deux tableaux, compare les données en utilisant une fonction de rappel.

    Liste de paramètres

    array

    Le premier tableau.

    arrays

    Tableaux à comparer contre

    value_compare_func

    La fonction de comparaison doit retourner un entier inférieur à, égal à, ou supérieur à 0 si le premier argument est considéré comme, respectivement, inférieur à, égal à, ou supérieur au second.

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

    Retourner des valeurs non-entières à partir de la fonction de comparaison, telles que float, entraînera une conversion interne de la valeur de retour du rappel en int. Ainsi, des valeurs telles que 0.99 et 0.1 seront toutes deux converties en une valeur entière de 0, ce qui comparera de telles valeurs comme égales.

    Attention

    La fonction de rappel de tri doit traiter n'importe quelle valeur de n'importe quel tableau dans n'importe quel ordre, quel que soit l'ordre dans lequel elles ont été initialement fournies. Cela s'explique par le fait que chaque tableau individuel est d'abord trié avant d'être comparé aux autres tableaux. Par exemple :

    <?php
    $arrayA     = ["chaîne", 1];
    $arrayB = [["value" => 1]];
    // $item1 et $item2 peuvent être l'une des valeurs suivantes : "chaîne", 1 ou ["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;
    };
    ?>

    Valeurs de retour

    Retourne un tableau contenant toutes les valeurs du tableau array qui sont présentes dans tous les arguments.

    Exemples

    Exemple #1 Exemple avec array_uintersect()

    <?php
    $array1     = array("a" => "green", "b" => "brown", "c" => "blue", "red");
    $array2 = array("a" => "GREEN", "B" => "brown", "yellow", "red");

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

    L'exemple ci-dessus va afficher :

    Array
(
    [a] => green
    [b] => brown
    [0] => red
)

    Voir aussi

    • array_intersect() - Calcule l'intersection de tableaux
    • array_intersect_assoc() - Calcule l'intersection de deux tableaux avec des tests sur les index
    • array_uintersect_assoc() - Calcule l'intersection de deux tableaux avec des tests sur l'index, compare les données en utilisant une fonction de rappel
    • array_uintersect_uassoc() - Calcule l'intersection de deux tableaux avec des tests sur l'index, compare les données et les index des deux tableaux en utilisant une fonction de rappel séparée

    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