MIME ヘッダ要素をデコードする

# imap_mime_header_decode

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

imap_mime_header_decode — MIME ヘッダ要素をデコードする

### 説明

function imap_mime_header_decode(string `$string`): array|false

非 ASCII テキストの MIME メッセージヘッダエクステンションをデコードします (» RFC2047 を参照ください)。

### パラメータ

`string`

  MIME テキスト。

### 戻り値

デコードされた要素は、オブジェクトの配列で返されます。 各オブジェクトは、二つのプロパティ `charset` と `text` を有しています。

要素がエンコードされていない場合、言い替えるとプレーンな US-ASCII の場合は この要素の `charset` プロパティは `default` に設定されます。

この関数は、失敗した時に `false` を返します。

### 例

例1 imap_mime_header_decode() の例

    <?php
    $text = "=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= <keld@example.com>";

    $elements = imap_mime_header_decode($text);
    for ($i=0; $i<count($elements); $i++) {
        echo "Charset: {$elements[$i]->charset}\n";
        echo "Text: {$elements[$i]->text}\n\n";
    }
    ?>

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

    Charset: ISO-8859-1
    Text: Keld Jørn Simonsen

    Charset: default
    Text:  <keld@example.com>

上の例には二つの要素があります。最初の要素は ISO-8859-1、 2 番目の要素はプレーンな US-ASCII で事前にエンコードされています。

### 参考

- imap_utf8() - MIME エンコードされたテキストを UTF-8 に変換する

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