Array Functions

PHP array_uintersect() Function

Topic: PHP Array ReferencePrev|Next

Description

The array_uintersect() function compares the values of two or more arrays and returns the matches using a user-defined value comparison function.

This is unlike array_intersect() which uses an internal function for comparing the values. Also, the keys are not considered in the comparison, only the values are checked.

The following table summarizes the technical details of this function.

Return Value: Returns an array containing all the elements from array1 whose values are present in all of the other arrays.
Version: PHP 5+

Syntax

The basic syntax of the array_uintersect() function is given with:

array_uintersect(array1, array2, ..., value_compare_function);

The following example shows the array_uintersect() function in action.

<?php
// Define value Comparison function
function compare($a, $b){
    // Converting value to lowercase
    $a = strtolower($a);
    $b = strtolower($b);

    if($a == $b){
        return 0;
    }
    return ($a < $b) ? -1 : 1;
}

// Sample arrays
$array1 = array("apple", "ball", "cat", "dog", "elephant");
$array2 = array("alligator", "DOG", "elephant", "lion", "Cat");

// Computing the intersection
$result = array_uintersect($array1, $array2, "compare");
print_r($result);
?>

Note: The value comparison function must return an integer equal to zero if both values are equal, an integer less than zero if the first value is less than the second value, and an integer greater than zero if the first value is greater than the second value.


Parameters

The array_uintersect() function accepts the following parameters.

Parameter Description
array1 Required. Specifies the array to compare from.
array2 Required. Specifies an array to compare against.
... Optional. Specifies more arrays to compare against.
value_compare_function Required. Specifies a callback function to use for value comparison.

More Examples

Here're some more examples showing how array_uintersect() function actually works:

The following example shows how to compare the values of three arrays and get the matches using the PHP's built-in strcasecmp() function as value comparison function.

<?php
// Sample arrays
$array1 = array("apple", "ball", "cat", "dog");
$array2 = array("Apple", "Cat", "Elephant");
$array3 = array("APPLE", "BANANA", "CAT");

// Computing the intersection
$result = array_uintersect($array1, $array2, $array3, "strcasecmp");
print_r($result);
?>

You can also use associative arrays, however the keys are not considered in the comparison.

<?php
// Sample arrays
$array1 = array("a"=>"red", "b"=>"green", "c"=>"blue", "d"=>"yellow");
$array2 = array("x"=>"black", "y"=>"BLUE", "z"=>"Red");

// Computing the intersection
$result = array_uintersect($array1, $array2, "strcasecmp");
print_r($result);
?>
Bootstrap UI Design Templates Property Marvels - A Leading Real Estate Portal for Premium Properties