Ruby 1.9.2 リファレンスマニュアル > ライブラリ一覧 > iconvライブラリ > Iconvクラス > new

singleton method Iconv.new

new(to, from, options = nil) -> Iconv[permalink][rdoc]

文字コード from から to へ変換するIconvオブジェクトを生成します。

[PARAM] to:

変換先の文字コード体系を表す文字列を指定します。

[PARAM] from:

変換前の文字コード体系を表す文字列を指定します。

[PARAM] options:

ハッシュ形式で transliterate、discard_ilseq に真か偽かを 与えてiconv/環境依存の機能 と同じ操作を行います。

[EXCEPTION] TypeError:

to や from が String オブジェクトでないとき発生します。

[EXCEPTION] Iconv::InvalidEncoding:

to や from で指定された文字コード体系が見つからないとき発生します。

[EXCEPTION] SystemCallError:

iconv_open(3) が失敗したとき発生します。

[EXCEPTION] ArgumentError:

options に transliterate、discard_ilseq 以外を指定 した場合に発生します。

[EXCEPTION] NotImplementedError:

実行プラットフォームでサポートされていないオ プションを指定した場合に発生します。

例:

require 'iconv'
# EUC-JP から SHIFT_JIS へ変換するIconvオブジェクトを生成。
icv = Iconv.new('SHIFT_JIS', 'EUC-JP')

[SEE_ALSO] Iconv.open