名前¶

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>

名前¶

概要¶

説明¶

ERRORS¶

NOTES¶

作者¶

SEE ALSO¶