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ãoDescrição
8.0.0array_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

To Top