array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-combine.php', 1 => 'array_combine', 2 => 'Cria um array usando um array para chaves e outro para valores', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-column.php', 1 => 'array_column', ), 'next' => array ( 0 => 'function.array-count-values.php', 1 => 'array_count_values', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-combine.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

array_combine

(PHP 5, PHP 7, PHP 8)

array_combine — Cria 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

Exemplo #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