singleton method Iconv.open

ブロックが与えられない場合は Iconv.new と等価です。ブロックが与えられると、Iconv オブジェクトを生成し、それを引数としてブロックを実行します。ブロックの終りに Iconv オブジェクトは close されます。ブロックの値を返します。

[PARAM] to:

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

[PARAM] from:

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

[PARAM] options:

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

[EXCEPTION] TypeError:

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

[EXCEPTION] Iconv::InvalidEncoding:

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

[EXCEPTION] ArgumentError:

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

[EXCEPTION] NotImplementedError:

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

例:

euc = ["a4a2a4a4a4a6a4a8a4aa"].pack("H*") # あいうえおのEUC-JPコード

Iconv.open("UTF-8", "EUC-JP") do |i|
  str = i.iconv(euc)
  str << i.iconv(nil)
end
puts str #=> あいうえお

[SEE_ALSO] Iconv.new