配列のキーと値を反転する

# array_flip

(PHP 4, PHP 5, PHP 7)

array_flip — 配列のキーと値を反転する

### 説明

array_flip ( array `$array` ) : array

array_flip() は、配列を反転して返します。 すなわち、`array` のキーが値となり、 `array` の値がキーとなります。

`array` の値は有効なキーを必要とすることに注意してください。 すなわち、キーは、integer または string である必要があります。ある値が間違った型である場合、 警告が出力され、問題のこのキー/値の組は結果には含まれません。

ある値が複数回出現した場合、最後のキーがその値として使用され、 その他の値は失われます。

### パラメータ

`array`

  反転を行うキー/値の組。

### 返り値

成功した場合に反転した配列、失敗した場合に `NULL` を返します。

### 例

例1 array_flip() の例

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

上の例の出力は以下となります。

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

例2 array_flip() の例 : 衝突

`<?php
$input = array("a" => 1, "b" => 1, "c" => 2);
$flipped = array_flip($input);
print_r($flipped);
?>`

上の例の出力は以下となります。

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

### 参考

- array_values() - 配列の全ての値を返す
- array_keys() - 配列のキーすべて、あるいはその一部を返す
- array_reverse() - 要素を逆順にした配列を返す