array_intersect_ukey

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

array_intersect_ukey — Computa a interseção de arrays usando uma função de retorno nas chaves para comparação

Descrição

array_intersect_ukey(array $array, array ...$arrays, callable $key_compare_func): array

array_intersect_ukey() retorna um array contendo todos os valores de array que têm as mesmas chaves presentes em todos os argumentos.

Parâmetros

array: Array inicial para comparação dos arrays.
arrays: Arrays para comparar as chaves.
key_compare_func: A função de comparação deve retornar um inteiro menor que, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor que, igual ou maior que o segundo.

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

Cuidado
Retornar valores não inteiros da função de comparação, como float, resultará em uma conversão interna do valor retornado da função callback para int. Portanto, valores como 0.99 e 0.1 serão convertidos para o valor inteiro 0, o que comparará esses valores como iguais.

Valor Retornado

Retorna os valores de array cujas chaves existem em todos os argumentos.

Exemplos

Exemplo #1 Exemplo da função array_intersect_ukey()

<?php
function key_compare_func($key1, $key2)
{
    if ($key1 == $key2)
        return 0;
    else if ($key1 > $key2)
        return 1;
    else
        return -1;
}

$array1 = array('azul'  => 1, 'vermelho' => 2, 'verde'   => 3, 'roxo'  => 4);
$array2 = array('verde' => 5, 'azul'     => 6, 'amarelo' => 7, 'rosa'  => 8);

var_dump(array_intersect_ukey($array1, $array2, 'key_compare_func'));
?>

O exemplo acima produzirá:

array(2) {
  ["azul"]=>
  int(1)
  ["verde"]=>
  int(3)
}

Em nosso exemplo, é possível ver que somente as chaves 'azul' e 'verde' estão presentes em ambos os arrays e assim retornadas. Observe também que os valores para as chaves 'azul' e 'verde' diferem entre os dois arrays. Uma combinação ainda ocorre porque somente as chaves são verificadas. Os valores retornados são os do array.

Veja Também

array_diff() - Computa as diferenças entre arrays
array_udiff() - Computa a diferença de arrays usando uma função de callback para comparação dos dados
array_diff_assoc() - Computa a diferença entre arrays com checagem adicional de índice
array_diff_uassoc() - Computa a diferença entre arrays com checagem adicional de índice que feita por uma função de callback fornecida pelo usuário
array_udiff_assoc() - Computa a diferença entre arrays com verificação adicional de índice, comparando dados por uma função de retorno
array_udiff_uassoc() - Computa a diferença entre arrays com checagem adicional de índice, compara dados e índices por uma função de callback
array_diff_key() - Computa a diferença entre arrays usando as chaves na comparação
array_diff_ukey() - Computa a diferença entre arrays usando uma função callback na comparação de chaves
array_intersect() - Calcula a interseção entre arrays
array_intersect_assoc() - Computa a interseção de arrays com uma adicional verificação de índice
array_intersect_uassoc() - Computa a interseção de arrays com checagem de índice adicional, compara índices por uma função de callback
array_intersect_key() - Calcula a interseção de arrays, comparando pelas chaves

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

down

lincoln dot du dot j at gmail dot com ¶

2 months ago

This is a cleaner and more modern approach (PHP 7.4+ syntax).<?php$array1 = ['blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4];$array2 = ['green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan' => 8];$result = array_intersect_ukey($array1, $array2, fn($a, $b) => $a <=> $b);var_dump($result);?>Explanation:The comparison function fn($a, $b) => $a <=> $b uses the spaceship operator directly inside the array_intersect_ukey call.The result will contain entries from $array1 whose keys also exist in $array2.Output:phpCopyEditarray(2) {  ["blue"]=>  int(1)  ["green"]=>  int(3)}

down

gk at anuary dot com ¶

11 years ago

"array_intersect_ukey" will not work if $key_compare_func is using regular expression to perform comparison. "_array_intersect_ukey" fully implements the "array_intersect_ukey" interface and handles properly boolean comparison. However, the native implementation should be preferred for efficiency reasons.<?php$key_compare_func = function ($a, $b) {    var_dump('a=' . $a. '; b=' . $b);        if (strpos($b, '/') === 0) {        return preg_match($b, $a) > 0 ? 0 : -1;    }        if ($a == $b) {        $weight = 0;    } else if ($a > $b) {        $weight = 1;    } else {        $weight = -1;    }        var_dump('literal comparison: ' . $weight);        return $weight;};$foo = ['aab' => '', 'bbb' => '', 'ccb' => '', 'abb' => ''];$bar = ['/[a-z]b[a-z]/' => ''];$buz = ['/c[a-z][a-z]/' => ''];echo PHP_EOL . 'array_intersect_ukey' . PHP_EOL . PHP_EOL;$subject = array_intersect_ukey ($foo, $bar, $buz, $key_compare_func);echo PHP_EOL;var_dump($subject);echo PHP_EOL . '_array_intersect_ukey' . PHP_EOL . PHP_EOL;$subject = _array_intersect_ukey($foo, $bar, $buz, $key_compare_func);echo PHP_EOL;var_dump($subject);/** * @author Gajus Kuizinas <gk@anuary.com> * @version 1.0.0 (2013 09 30) * @url https://gist.github.com/gajus/271ad5f36337a32a184c */function _array_intersect_ukey (array $arr1, array $arr2, $key_compare_func) {    $arr_matched = [];    $arr_unmatched = [];        $args = func_get_args();        $key_compare_func = end($args);        foreach ($arr1 as $k1 => $v1) {        foreach ($arr2 as $k2 => $v2) {            $diff = $key_compare_func($k1, $k2);                    //var_dump('k1=' . $k1 . ', k2=' . $k2 . ', diff=' . $diff);                        if ($diff === 0) {                $arr_matched[$k1] = $v1;            } else {                $arr_unmatched[$k1] = $v1;            }        }    }        if (count($args) <= 3) {        return $arr_matched;    }        array_splice($args, 0, 2, [$arr_unmatched]);        return array_merge($arr_matched, call_user_func_array('_array_intersect_ukey', $args));}/*array_intersect_ukeystring(12) "a=bbb; b=aab"string(21) "literal comparison: 1"string(12) "a=bbb; b=ccb"string(22) "literal comparison: -1"string(12) "a=abb; b=bbb"string(22) "literal comparison: -1"string(12) "a=aab; b=abb"string(22) "literal comparison: -1"string(22) "a=aab; b=/[a-z]b[a-z]/"string(22) "a=abb; b=/[a-z]b[a-z]/"string(22) "a=abb; b=/c[a-z][a-z]/"array(0) {}_array_intersect_ukeystring(22) "a=aab; b=/[a-z]b[a-z]/"string(22) "a=bbb; b=/[a-z]b[a-z]/"string(22) "a=ccb; b=/[a-z]b[a-z]/"string(22) "a=abb; b=/[a-z]b[a-z]/"string(22) "a=aab; b=/c[a-z][a-z]/"string(22) "a=ccb; b=/c[a-z][a-z]/"array(3) {  ["bbb"]=>  string(0) ""  ["abb"]=>  string(0) ""  ["ccb"]=>  string(0) ""}*/?>

＋adicione uma nota