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

# array_combine

(PHP 5, PHP 7, PHP 8)

array_combine — Cria um array usando um array para chaves e outro para valores

### Descrição

function 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

- array_merge() - Combina um ou mais arrays
- array_walk() - Aplica uma determinada função em cada elemento de um array
- array_values() - Retorna todos os valores de um array
- array_map() - Aplica uma função em todos os elementos dos arrays dados

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open