mb_encoding_aliases

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

mb_encoding_aliases — 既知のエンコーディング・タイプのエイリアスを取得

説明

mb_encoding_aliases(string $encoding): array

既知の encoding タイプに関するエイリアスの配列を返します。

パラメータ

encoding: エイリアスに関してチェックするエンコーディングタイプ。

戻り値

数値インデックス付きの、エンコーディング・エイリアスの配列を返します。

エラー / 例外

encoding が未知の値の場合、 ValueError がスローされます。

変更履歴

バージョン	説明
8.0.0	`encoding` が未知の値の場合、 ValueError がスローされるようになりました。これより前のバージョンでは、`E_WARNING` が発生し、`false` を返していました。

例

例1 mb_encoding_aliases() 例

<?php
$encoding        = 'ASCII';
$known_encodings = mb_list_encodings();

if (in_array($encoding, $known_encodings)) {

    $aliases = mb_encoding_aliases($encoding);
    print_r($aliases);

} else {

    echo "Unknown ($encoding) encoding.\n";

}
?>

上の例の出力は、たとえば以下のようになります。

Array
(
    [0] => ANSI_X3.4-1968
    [1] => iso-ir-6
    [2] => ANSI_X3.4-1986
    [3] => ISO_646.irv:1991
    [4] => US-ASCII
    [5] => ISO646-US
    [6] => us
    [7] => IBM367
    [8] => cp367
    [9] => csASCII
)

参考

mb_list_encodings() - サポートするすべてのエンコーディングの配列を返す