POD2::JA::Encode::MIME::EncWords(3p)

NAME
Encode::MIME::EncWords~[ja] - MIME の「B」・「Q」ヘッダエンコーディング (代替案)

SYNOPSIS
    use Encode::MIME::EncWords;
    use Encode qw/encode decode/;

    # ヘッダデコードする。
    $utf8   = decode('MIME-EncWords', $header);

    # 初期のキャラクタセット (UTF-8) でヘッダエンコードする。
    $header = encode('MIME-EncWords', $utf8);

    # ほかのキャラクタセットでヘッダエンコードする。
    Encode::MIME::EncWords->config(Charset => 'GB2312');
    $header = encode('MIME-EncWords', $utf8);

ABSTRACT
このモジュールは、RFC 2047 に述べる MIME のヘッダエンコーディングを実装している。 エンコーディングの名前には、みっつの変種と、 キャラクタセットに特化したひとつの簡易版がある。

  エンコーディング名         encode() の結果        備考
  ------------------------------------------------------------------
  MIME-EncWords              (B と Q を自動判別)
  MIME-EncWords-B            =?XXXX?B?...?=         初期値は UTF-8。
  MIME-EncWords-Q            =?XXXX?Q?...?=                ,,
  MIME-EncWords-ISO_2022_JP  =?ISO-2022-JP?B?...?=

decode() の結果は、どのエンコーディングでも同じになる。

DESCRIPTION
このモジュールは、Encode::MIME::Header コアモジュールが提供する "MIME-*" エンコーディングの代替となることを意図している。 このモジュールの使いかたをよく知るためには、Encode を参照してほしい。

  モジュール独自の機能

config(KEY => VALUE, ...);
    クラスメソッド。 KEY => VALUE の対でオプションを設定する。 次のオプションが使える。

    Charset
        [encode] データ要素を変換するのに使うキャラクタセット。 初期値は "UTF-8"。 "MIME-EncWords-ISO_2022_JP" では "ISO-2022-JP" に固定。

    Detect7bit
        [decode/encode] エンコードされていない部分の 7 ビットキャラクタセットを判別しようとする。 初期値は "YES"。

    Field
        [encode] ヘッダフィールドの名前。エンコードされた結果の最初の行で、 これの長さが考慮される。 初期値は "undef"。

    Mapping
        [decode/encode] キャラクタセットの名前に対して実際に使うマッピングを指定する。 初期値は "EXTENDED"。

    MaxLineLen
        [encode] 行の最大長 (改行を除く)。 初期値は 76。

    Minimal
        [encode] エンコーディングを最小限にするか否か。 初期値は "YES"。

    オプションの詳細については MIME::EncWords~[ja] を参照。

CAVEAT

•   MIME ヘッダエンコーディング用のエンコーディングモジュールは、 こみいったヘッダフィールドを簡単に作り出したり、 そこから望みの要素を取り出したりできる打ち出の小槌ではない。

    アドレスヘッダフィールド (To:、From: など) をデコードするには、 まず mailbox-list を分解する。 そして、個々の要素をエンコーディングモジュールでデコードする。 これをエンコードするには、 今度は個々の要素をエンコーディングモジュールでエンコードする。 そして、エンコードした要素から mailbox-list を組み立てる。 mailbox-list の組み立てや分解には、Mail::Address のようなモジュールが使えるだろう。

•   行を LF ("\n") で区切る。 RFC5322 は、インターネットのメッセージでは行を CRLF ("\r\n") で区切るとしている。

BUGS
バグやバグのような動作は開発者に知らせてください。

CPAN Request Tracker: <http://rt.cpan.org/Public/Dist/Display.html?Name=MIME-EncWords>.

VERSION
$VERSION 変数を参照してほしい。

これは実験的なリリースである。仕様は近い将来、変わるかもしれない。

このパッケージの開発版が次の場所にある。 <http://hatuka.nezumi.nu/repos/MIME-EncWords/>。

SEE ALSO
Encode, Encode::MIME::Header, MIME::EncWords~[ja].

RFC 2047 MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text.

AUTHOR
Hatuka*nezumi - IKEDA Soji <hatuka(at)nezumi.nu>

COPYRIGHT
Copyright (C) 2011 Hatuka*nezumi - IKEDA Soji.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.