Text-Iconv-1.2 > Text::Iconv
名前¶
Text::Iconv - コードセット変換関数iconv()へのPerlインターフェース
概要¶
use Text::Iconv;
$converter = Text::Iconv->new("fromcode", "tocode");
$converted = $converter->convert("Text to convert");
説明¶
Text::Iconvモジュールは、Unix単体の仕様で定義されるiconv()関数への Perlインターフェースを提供します。convert()メソッドは入力文字列中の 文字のエンコードをfromcodeコードセットからtocodeに変換し、結果を 返します。
fromcodeとtocodeの設定と許可される組み合わせは、実装依存です。 適切な値はシステムのドキュメントで指定されます。
ERRORS¶
変換の初期化ができなかった時は、例外が(croak()を使用して)発生させ られます。
試験的な機能として、このバージョンのText:Iconvは新たに raise_errorクラスアトリビュートと、この値の設定および取得に相当する クラスメソッドを提供します。現在、変換中のエラーのハンドリングはこの アトリビュートによります。raise_errorにTrue値が設定されている時は、 例外が発生します; そうでなければ、convert()メソッドはundefを返すに 留まります。デフォルトではraise_errorはFalseです。ワーニングはもう でません。例:
Text::Iconv->raise_error(1); # 変換エラー時には例外を発生させる
Text::Iconv->raise_error(0); # 変換エラー時にはundefを返す
$a = Text::Iconv->raise_error(); # 現在の設定を取得
発生しうるエラーの詳細についてはiconv(3)を調べてください。
undefの変換、例えば、
$converted = $converter->convert(undef);
は常にundefを返します。これはエラーと見なされません。
NOTES¶
サポートされるコードセット、その名称、サポートされる変換、それから 変換のクオリティは全てシステム依存です。
作者¶
Michael Piotrowski <mxp@dynalabs.de>
SEE ALSO¶
iconv(1), iconv(3)