Função PHP array_combine ()
Definição e Uso
o array_combine() função pega dois arrays diferentes ou iguais como entrada e cria um novo array usando os valores do keys array como chaves e os valores do values array como os valores correspondentes.
Ao passar dois arrays na função, certifique-se de que o número de elementos em ambos os arrays são iguais, caso contrário, retornará um erro.
Sintaxe
array array_combine ( array $keys, array $values );
Parâmetros
Sr. Não | Parâmetro e Descrição |
---|---|
1 |
keys (mandatory) Primeiro array cujos valores serão usados como chaves para criar um novo array. |
2 |
values (mandatory) Segunda matriz cujos valores serão usados como os valores para criar a nova matriz. |
Valores Retornados
A função PHP array_combine () retorna o array combinado caso contrário FALSE se o número de elementos para cada array não for igual ou se os arrays estiverem vazios.
Versão PHP
Esta função foi introduzida pela primeira vez no PHP versão 5.0.0.
Erros / exceções
Se o número de elementos nas matrizes de chaves e valores não corresponderem, será gerado E_WARNING.
Exemplo
A seguir está o exemplo em que estamos usando dois arrays diferentes para combiná-los em um array -
<?php
$a = array('green', 'red', 'yellow');
$b = array('avocado', 'apple', 'banana');
$c = array_combine($a, $b);
print_r($c);
?>
Isso produzirá o seguinte resultado -
Array
(
[green] => avocado
[red] => apple
[yellow] => banana
)
Exemplo
A seguir está o exemplo onde estamos usando dois arrays diferentes para combiná-los em um array, mas desta vez estamos usando um número desigual de elementos em ambos os arrays -
<?php
$a = array('green', 'red', 'yellow');
$b = array('avocado', 'apple');
$c = array_combine($a, $b);
print_r($c);
?>
Isso produzirá o seguinte resultado -
PHP Warning: array_combine(): Both parameters should have an equal number of elements in main.php on line 4
Exemplo
Se duas chaves são iguais, a segunda prevalece, mas é absolutamente válida -
<?php
$a = array('green', 'green', 'yellow');
$b = array('avocado', 'apple', 'banana');
$c = array_combine($a, $b);
print_r($c);
?>
Isso produzirá o seguinte resultado -
Array
(
[green] => apple
[yellow] => banana
)
Exemplo
Podemos criar uma nova matriz usando a mesma matriz de entrada, experimente o seguinte exemplo -
<?php
$a = array('green', 'green', 'yellow');
$c = array_combine($a, $a);
print_r($c);
?>
Isso produzirá o seguinte resultado -
Array
(
[green] => green
[yellow] => yellow
)