array_flip

(PHP 4, PHP 5, PHP 7, PHP 8)

array_flip — Permuta todas as chaves e seus valores associados em um array

Descrição

array_flip(array $array): array

array_flip() retorna um array com suas relações trocadas, ou seja, as chaves de array passam a ser os valores e os valores de array passam a ser as chaves.

Note que os valores de array devem ser chaves válidas, ou seja, eles precisam ser int ou string. Um aviso será mostrado se um valor é de um tipo inválido para chaves, e o par chave/valor em questão não será invertido.

Se um valor tem várias ocorrências, a última chave será usada como valor, e todos os outros serão perdidos.

Parâmetros

array

Um array de pares chave/valor para inverter.

Valor Retornado

Retorna o array trocado.

Exemplos

Example #1 Exemplo da função array_flip()

<?php
$input = array("oranges", "apples", "pears");
$flipped = array_flip($input);

print_r($flipped);
?>

O exemplo acima produzirá:

Array
(
    [oranges] => 0
    [apples] => 1
    [pears] => 2
)

Example #2 Exemplo da função array_flip(): colisão

<?php
$trans = array("a" => 1, "b" => 1, "c" => 2);
$trans = array_flip($trans);

print_r($trans);
?>

O exemplo acima produzirá:

Array
(
    [1] => b
    [2] => c
)

Veja Também