array_combine

(PHP 5, PHP 7, PHP 8)

array_combineCria um array usando um array para chaves e outro para valores

Descrição

array_combine(array $keys, array $values): array

Cria um array usando os valores do array keys como chaves e os valores do array values como valores correspondentes.

Parâmetros

keys

Array a ser usado como chaves. Valores ilegais para chave serão convertidos para string.

values

Array a ser usado como valores

Valor Retornado

Retorna o array combinado.

Erros/Exceções

A partir do PHP 8.0.0, a ValueError é disparado se o número de elementos em keys e values não correspondem. Antes do PHP 8.0.0, um E_WARNING será disparado no lugar.

Registro de Alterações

Versão Descrição
8.0.0 array_combine() será agora dispara ValueError se o numero de elementos para cada array não é igual; antes esta função retorna false no lugar.

Exemplos

Example #1 Um simples exemplo usando a função array_combine()

<?php
$a = array('verde', 'vermelho', 'amarelo');
$b = array('abacate', 'maçã', 'banana');
$c = array_combine($a, $b);

print_r($c);
?>

O exemplo acima produzirá:

Array
(
    [verde] => abacate
    [vermelho] => maçã
    [amarelo] => banana
)

Veja Também