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に変換し、結果を 返します。

fromcodetocodeの設定と許可される組み合わせは、実装依存です。 適切な値はシステムのドキュメントで指定されます。

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)