Ruby 2.2.0 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Encoding::UndefinedConversionErrorクラス

class Encoding::UndefinedConversionError

クラスの継承リスト: Encoding::UndefinedConversionError < EncodingError < StandardError < Exception < Object < Kernel < BasicObject

要約

エンコーディング変換後の文字が存在しない場合に発生する例外。

UTF-8 にしかない文字を EUC-JP に変換しようとした場合などに発生します。

"\u2603".encode(Encoding::EUC_JP)
#=> Encoding::UndefinedConversionError: U+2603 from UTF-8 to EUC-JP

変換が多段階でなされ、その途中で例外が生じた場合は、 例外オブジェクトが保持するエラー情報はその中間のものになります。

ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP")
# ISO-8859-1 -> UTF-8 -> EUC-JP
begin
  ec.convert("\xa0")
  # NO-BREAK SPACE, which is available in UTF-8 but not in EUC-JP.
rescue Encoding::UndefinedConversionError
  p $!.source_encoding              #=> #<Encoding:UTF-8>
  p $!.destination_encoding         #=> #<Encoding:EUC-JP>
  p $!.source_encoding_name         #=> "UTF-8"
  p $!.destination_encoding_name    #=> "EUC-JP"
  puts $!.error_char.dump   #=> "\u{a0}"
  p $!.error_char.encoding  #=> #<Encoding:UTF-8>
end

インスタンスメソッド

定義 説明
destination_encoding -> Encoding

エラーを発生させた変換の変換先のエンコーディングを Encoding オブジェクトで返します。

destination_encoding_name -> String

エラーを発生させた変換の変換先のエンコーディングを文字列で返します。

error_char -> String

エラーを発生させた1文字を文字列で返します。

source_encoding -> Encoding

エラーを発生させた変換の変換元のエンコーディングを Encoding オブジェクトで返します。

source_encoding_name -> Encoding

エラーを発生させた変換の変換元のエンコーディングを文字列で返します。

継承したメソッド

! != __id__ instance_eval instance_exec singleton_method_added singleton_method_removed singleton_method_undefined == backtrace backtrace_locations cause exception inspect message set_backtrace to_json .exception .json_create !~ <=> === =~ __send__ _dump class clone define_singleton_method display enum_for eql? equal? extend freeze frozen? hash initialize initialize_copy instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? itself marshal_dump marshal_load method method_missing methods nil? object_id pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods psych_to_yaml public_method public_methods public_send remove_instance_variable respond_to? respond_to_missing? singleton_class singleton_method singleton_methods taint tainted? tap to_a to_ary to_hash to_int to_io to_proc to_regexp to_str trust untaint untrust untrusted? .yaml_tag ::ARGF ::ARGV ::DATA ::ENV ::FALSE ::NIL ::RUBY_COPYRIGHT ::RUBY_DESCRIPTION ::RUBY_ENGINE ::RUBY_PATCHLEVEL ::RUBY_PLATFORM ::RUBY_RELEASE_DATE ::RUBY_REVISION ::RUBY_VERSION ::SCRIPT_LINES__ ::STDERR ::STDIN ::STDOUT ::TOPLEVEL_BINDING ::TRUE