rbs 2.8.4 → 3.8.1

data/core/encoding.rbs

@@ -1,197 +1,58 @@
 # <!-- rdoc-file=encoding.c -->
 # An Encoding instance represents a character encoding usable in Ruby. It is
-# defined as a constant under the Encoding namespace. It has a name and
+# defined as a constant under the Encoding namespace. It has a name and,
 # optionally, aliases:
 #
-#     Encoding::ISO_8859_1.name
-#     #=> "ISO-8859-1"
+#     Encoding::US_ASCII.name  # => "US-ASCII"
+#     Encoding::US_ASCII.names # => ["US-ASCII", "ASCII", "ANSI_X3.4-1968", "646"]
 #
-#     Encoding::ISO_8859_1.names
-#     #=> ["ISO-8859-1", "ISO8859-1"]
+# A Ruby method that accepts an encoding as an argument will accept:
 #
-# Ruby methods dealing with encodings return or accept Encoding instances as
-# arguments (when a method accepts an Encoding instance as an argument, it can
-# be passed an Encoding name or alias instead).
+# *   An Encoding object.
+# *   The name of an encoding.
+# *   An alias for an encoding name.
 #
-#     "some string".encoding
-#     #=> #<Encoding:UTF-8>
+# These are equivalent:
 #
-#     string = "some string".encode(Encoding::ISO_8859_1)
-#     #=> "some string"
-#     string.encoding
-#     #=> #<Encoding:ISO-8859-1>
+#     'foo'.encode(Encoding::US_ASCII) # Encoding object.
+#     'foo'.encode('US-ASCII')         # Encoding name.
+#     'foo'.encode('ASCII')            # Encoding alias.
 #
-#     "some string".encode "ISO-8859-1"
-#     #=> "some string"
+# For a full discussion of encodings and their uses, see [the Encodings
+# document](rdoc-ref:encodings.rdoc).
 #
-# Encoding::ASCII_8BIT is a special encoding that is usually used for a byte
-# string, not a character string. But as the name insists, its characters in the
-# range of ASCII are considered as ASCII characters.  This is useful when you
-# use ASCII-8BIT characters with other ASCII compatible characters.
+# Encoding::ASCII_8BIT is a special-purpose encoding that is usually used for a
+# string of bytes, not a string of characters. But as the name indicates, its
+# characters in the ASCII range are considered as ASCII characters. This is
+# useful when you use other ASCII-compatible encodings.
 #
-# ## Changing an encoding
-#
-# The associated Encoding of a String can be changed in two different ways.
-#
-# First, it is possible to set the Encoding of a string to a new Encoding
-# without changing the internal byte representation of the string, with
-# String#force_encoding. This is how you can tell Ruby the correct encoding of a
-# string.
-#
-#     string
-#     #=> "R\xC3\xA9sum\xC3\xA9"
-#     string.encoding
-#     #=> #<Encoding:ISO-8859-1>
-#     string.force_encoding(Encoding::UTF_8)
-#     #=> "R\u00E9sum\u00E9"
-#
-# Second, it is possible to transcode a string, i.e. translate its internal byte
-# representation to another encoding. Its associated encoding is also set to the
-# other encoding. See String#encode for the various forms of transcoding, and
-# the Encoding::Converter class for additional control over the transcoding
-# process.
-#
-#     string
-#     #=> "R\u00E9sum\u00E9"
-#     string.encoding
-#     #=> #<Encoding:UTF-8>
-#     string = string.encode!(Encoding::ISO_8859_1)
-#     #=> "R\xE9sum\xE9"
-#     string.encoding
-#     #=> #<Encoding::ISO-8859-1>
-#
-# ## Script encoding
-#
-# All Ruby script code has an associated Encoding which any String literal
-# created in the source code will be associated to.
-#
-# The default script encoding is Encoding::UTF_8 after v2.0, but it can be
-# changed by a magic comment on the first line of the source code file (or
-# second line, if there is a shebang line on the first). The comment must
-# contain the word `coding` or `encoding`, followed by a colon, space and the
-# Encoding name or alias:
-#
-#     # encoding: UTF-8
-#
-#     "some string".encoding
-#     #=> #<Encoding:UTF-8>
-#
-# The `__ENCODING__` keyword returns the script encoding of the file which the
-# keyword is written:
-#
-#     # encoding: ISO-8859-1
-#
-#     __ENCODING__
-#     #=> #<Encoding:ISO-8859-1>
-#
-# `ruby -K` will change the default locale encoding, but this is not
-# recommended. Ruby source files should declare its script encoding by a magic
-# comment even when they only depend on US-ASCII strings or regular expressions.
-#
-# ## Locale encoding
-#
-# The default encoding of the environment. Usually derived from locale.
-#
-# see Encoding.locale_charmap, Encoding.find('locale')
-#
-# ## Filesystem encoding
-#
-# The default encoding of strings from the filesystem of the environment. This
-# is used for strings of file names or paths.
-#
-# see Encoding.find('filesystem')
-#
-# ## External encoding
-#
-# Each IO object has an external encoding which indicates the encoding that Ruby
-# will use to read its data. By default Ruby sets the external encoding of an IO
-# object to the default external encoding. The default external encoding is set
-# by locale encoding or the interpreter `-E` option. Encoding.default_external
-# returns the current value of the external encoding.
-#
-#     ENV["LANG"]
-#     #=> "UTF-8"
-#     Encoding.default_external
-#     #=> #<Encoding:UTF-8>
-#
-#     $ ruby -E ISO-8859-1 -e "p Encoding.default_external"
-#     #<Encoding:ISO-8859-1>
-#
-#     $ LANG=C ruby -e 'p Encoding.default_external'
-#     #<Encoding:US-ASCII>
-#
-# The default external encoding may also be set through
-# Encoding.default_external=, but you should not do this as strings created
-# before and after the change will have inconsistent encodings.  Instead use
-# `ruby -E` to invoke ruby with the correct external encoding.
-#
-# When you know that the actual encoding of the data of an IO object is not the
-# default external encoding, you can reset its external encoding with
-# IO#set_encoding or set it at IO object creation (see IO.new options).
-#
-# ## Internal encoding
-#
-# To process the data of an IO object which has an encoding different from its
-# external encoding, you can set its internal encoding. Ruby will use this
-# internal encoding to transcode the data when it is read from the IO object.
-#
-# Conversely, when data is written to the IO object it is transcoded from the
-# internal encoding to the external encoding of the IO object.
-#
-# The internal encoding of an IO object can be set with IO#set_encoding or at IO
-# object creation (see IO.new options).
-#
-# The internal encoding is optional and when not set, the Ruby default internal
-# encoding is used. If not explicitly set this default internal encoding is
-# `nil` meaning that by default, no transcoding occurs.
-#
-# The default internal encoding can be set with the interpreter option `-E`.
-# Encoding.default_internal returns the current internal encoding.
-#
-#     $ ruby -e 'p Encoding.default_internal'
-#     nil
-#
-#     $ ruby -E ISO-8859-1:UTF-8 -e "p [Encoding.default_external, \
-#       Encoding.default_internal]"
-#     [#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>]
-#
-# The default internal encoding may also be set through
-# Encoding.default_internal=, but you should not do this as strings created
-# before and after the change will have inconsistent encodings.  Instead use
-# `ruby -E` to invoke ruby with the correct internal encoding.
-#
-# ## IO encoding example
-#
-# In the following example a UTF-8 encoded string "Ru00E9sumu00E9" is transcoded
-# for output to ISO-8859-1 encoding, then read back in and transcoded to UTF-8:
-#
-#     string = "R\u00E9sum\u00E9"
-#
-#     open("transcoded.txt", "w:ISO-8859-1") do |io|
-#       io.write(string)
-#     end
-#
-#     puts "raw text:"
-#     p File.binread("transcoded.txt")
-#     puts
-#
-#     open("transcoded.txt", "r:ISO-8859-1:UTF-8") do |io|
-#       puts "transcoded text:"
-#       p io.read
-#     end
-#
-# While writing the file, the internal encoding is not specified as it is only
-# necessary for reading.  While reading the file both the internal and external
-# encoding must be specified to obtain the correct result.
-#
-#     $ ruby t.rb
-#     raw text:
-#     "R\xE9sum\xE9"
-#
-#     transcoded text:
-#     "R\u00E9sum\u00E9"
-#
-class Encoding < Object
+class Encoding
+  def self._load: [T] (T) -> T
+
+  # <!--
+  #   rdoc-file=encoding.c
+  #   - Encoding.locale_charmap -> string
+  # -->
+  # Returns the locale charmap name. It returns nil if no appropriate information.
+  #
+  #     Debian GNU/Linux
+  #       LANG=C
+  #         Encoding.locale_charmap  #=> "ANSI_X3.4-1968"
+  #       LANG=ja_JP.EUC-JP
+  #         Encoding.locale_charmap  #=> "EUC-JP"
+  #
+  #     SunOS 5
+  #       LANG=C
+  #         Encoding.locale_charmap  #=> "646"
+  #       LANG=ja
+  #         Encoding.locale_charmap  #=> "eucJP"
+  #
+  # The result is highly platform dependent. So
+  # Encoding.find(Encoding.locale_charmap) may cause an error. If you need some
+  # encoding object even for unknown locale, Encoding.find("locale") can be used.
+  #
+  def self.locale_charmap: () -> String
+
   # <!--
   #   rdoc-file=encoding.c
   #   - Encoding.aliases -> {"alias1" => "orig1", "alias2" => "orig2", ...}
@@ -202,7 +63,7 @@ class Encoding < Object
   #     #=> {"BINARY"=>"ASCII-8BIT", "ASCII"=>"US-ASCII", "ANSI_X3.4-1968"=>"US-ASCII",
   #           "SJIS"=>"Windows-31J", "eucJP"=>"EUC-JP", "CP932"=>"Windows-31J"}
   #
-  def self.aliases: () -> ::Hash[String, String]
+  def self.aliases: () -> Hash[String, String]
 
   # <!--
   #   rdoc-file=encoding.c
@@ -247,7 +108,6 @@ class Encoding < Object
   # *   String#inspect
   # *   Regexp#inspect
   #
-  #
   # While strings created from these locations will have this encoding, the
   # encoding may not be valid.  Be sure to check String#valid_encoding?.
   #
@@ -272,8 +132,8 @@ class Encoding < Object
   # See Encoding::default_external for information on how the default external
   # encoding is used.
   #
-  def self.default_external=: (String arg0) -> String
-                            | (Encoding arg0) -> Encoding
+  def self.default_external=: (Encoding enc) -> Encoding
+                            | [T < _ToStr] (T enc) -> T
 
   # <!--
   #   rdoc-file=encoding.c
@@ -295,7 +155,6 @@ class Encoding < Object
   # *   Values from ENV
   # *   Values in ARGV including $PROGRAM_NAME
   #
-  #
   # Additionally String#encode and String#encode! use the default internal
   # encoding if no encoding is given.
   #
@@ -319,9 +178,9 @@ class Encoding < Object
   # See Encoding::default_internal for information on how the default internal
   # encoding is used.
   #
-  def self.default_internal=: (String arg0) -> String?
-                            | (Encoding arg0) -> Encoding?
-                            | (nil arg0) -> nil
+  def self.default_internal=: (Encoding enc) -> Encoding
+                            | [T < _ToStr] (T enc) -> T
+                            | (nil) -> nil
 
   # <!--
   #   rdoc-file=encoding.c
@@ -336,10 +195,13 @@ class Encoding < Object
   #
   # "external"
   # :   default external encoding
+  #
   # "internal"
   # :   default internal encoding
+  #
   # "locale"
   # :   locale encoding
+  #
   # "filesystem"
   # :   filesystem encoding
   #
@@ -348,7 +210,7 @@ class Encoding < Object
   # `Encoding.find("internal")` however returns nil when no encoding named
   # "internal", in other words, when Ruby has no default internal encoding.
   #
-  def self.find: (String | Encoding arg0) -> Encoding
+  def self.find: (encoding enc) -> Encoding?
 
   # <!--
   #   rdoc-file=encoding.c
@@ -367,7 +229,7 @@ class Encoding < Object
   #     #=> [#<Encoding:ASCII-8BIT>, #<Encoding:UTF-8>,
   #           #<Encoding:US-ASCII>, #<Encoding:ISO-2022-JP (dummy)>]
   #
-  def self.list: () -> ::Array[Encoding]
+  def self.list: () -> Array[Encoding]
 
   # <!--
   #   rdoc-file=encoding.c
@@ -381,7 +243,7 @@ class Encoding < Object
   #           "Windows-31J",
   #           "BINARY", "CP932", "eucJP"]
   #
-  def self.name_list: () -> ::Array[String]
+  def self.name_list: () -> Array[String]
 
   # <!--
   #   rdoc-file=encoding.c
@@ -433,17 +295,7 @@ class Encoding < Object
   #
   #     Encoding::WINDOWS_31J.names  #=> ["Windows-31J", "CP932", "csWindows31J", "SJIS", "PCK"]
   #
-  def names: () -> ::Array[String]
-
-  # <!--
-  #   rdoc-file=encoding.c
-  #   - enc.replicate(name) -> encoding
-  # -->
-  # Returns a replicated encoding of *enc* whose name is *name*. The new encoding
-  # should have the same byte structure of *enc*. If *name* is used by another
-  # encoding, raise ArgumentError.
-  #
-  def replicate: (String name) -> Encoding
+  def names: () -> Array[String]
 
   # <!--
   #   rdoc-file=encoding.c
@@ -454,427 +306,405 @@ class Encoding < Object
   #
   #     Encoding::UTF_8.name      #=> "UTF-8"
   #
-  def to_s: () -> String
+  alias to_s name
+
+  ANSI_X3_4_1968: Encoding
+  ASCII: Encoding
+  ASCII_8BIT: Encoding
+  BIG5: Encoding
+  BIG5_HKSCS: Encoding
+  BIG5_HKSCS_2008: Encoding
+  BIG5_UAO: Encoding
+  BINARY: Encoding
+  Big5: Encoding
+  Big5_HKSCS: Encoding
+  Big5_HKSCS_2008: Encoding
+  Big5_UAO: Encoding
+  CESU_8: Encoding
+  CP1250: Encoding
+  CP1251: Encoding
+  CP1252: Encoding
+  CP1253: Encoding
+  CP1254: Encoding
+  CP1255: Encoding
+  CP1256: Encoding
+  CP1257: Encoding
+  CP1258: Encoding
+  CP437: Encoding
+  CP50220: Encoding
+  CP50221: Encoding
+  CP51932: Encoding
+  CP65000: Encoding
+  CP65001: Encoding
+  CP737: Encoding
+  CP775: Encoding
+  CP850: Encoding
+  CP852: Encoding
+  CP855: Encoding
+  CP857: Encoding
+  CP860: Encoding
+  CP861: Encoding
+  CP862: Encoding
+  CP863: Encoding
+  CP864: Encoding
+  CP865: Encoding
+  CP866: Encoding
+  CP869: Encoding
+  CP874: Encoding
+  CP878: Encoding
+  CP932: Encoding
+  CP936: Encoding
+  CP949: Encoding
+  CP950: Encoding
+  CP951: Encoding
+  CSWINDOWS31J: Encoding
+  CsWindows31J: Encoding
+  EBCDIC_CP_US: Encoding
+  EMACS_MULE: Encoding
+  EUCCN: Encoding
+  EUCJP: Encoding
+  EUCJP_MS: Encoding
+  EUCKR: Encoding
+  EUCTW: Encoding
+  EUC_CN: Encoding
+  EUC_JISX0213: Encoding
+  EUC_JIS_2004: Encoding
+  EUC_JP: Encoding
+  EUC_JP_MS: Encoding
+  EUC_KR: Encoding
+  EUC_TW: Encoding
+  Emacs_Mule: Encoding
+  EucCN: Encoding
+  EucJP: Encoding
+  EucJP_ms: Encoding
+  EucKR: Encoding
+  EucTW: Encoding
+  GB12345: Encoding
+  GB18030: Encoding
+  GB1988: Encoding
+  GB2312: Encoding
+  GBK: Encoding
+  IBM037: Encoding
+  IBM437: Encoding
+  IBM737: Encoding
+  IBM720: Encoding
+  CP720: Encoding
+  IBM775: Encoding
+  IBM850: Encoding
+  IBM852: Encoding
+  IBM855: Encoding
+  IBM857: Encoding
+  IBM860: Encoding
+  IBM861: Encoding
+  IBM862: Encoding
+  IBM863: Encoding
+  IBM864: Encoding
+  IBM865: Encoding
+  IBM866: Encoding
+  IBM869: Encoding
+  ISO2022_JP: Encoding
+  ISO2022_JP2: Encoding
+  ISO8859_1: Encoding
+  ISO8859_10: Encoding
+  ISO8859_11: Encoding
+  ISO8859_13: Encoding
+  ISO8859_14: Encoding
+  ISO8859_15: Encoding
+  ISO8859_16: Encoding
+  ISO8859_2: Encoding
+  ISO8859_3: Encoding
+  ISO8859_4: Encoding
+  ISO8859_5: Encoding
+  ISO8859_6: Encoding
+  ISO8859_7: Encoding
+  ISO8859_8: Encoding
+  ISO8859_9: Encoding
+  ISO_2022_JP: Encoding
+  ISO_2022_JP_2: Encoding
+  ISO_2022_JP_KDDI: Encoding
+  ISO_8859_1: Encoding
+  ISO_8859_10: Encoding
+  ISO_8859_11: Encoding
+  ISO_8859_13: Encoding
+  ISO_8859_14: Encoding
+  ISO_8859_15: Encoding
+  ISO_8859_16: Encoding
+  ISO_8859_2: Encoding
+  ISO_8859_3: Encoding
+  ISO_8859_4: Encoding
+  ISO_8859_5: Encoding
+  ISO_8859_6: Encoding
+  ISO_8859_7: Encoding
+  ISO_8859_8: Encoding
+  ISO_8859_9: Encoding
+  KOI8_R: Encoding
+  KOI8_U: Encoding
+  MACCENTEURO: Encoding
+  MACCROATIAN: Encoding
+  MACCYRILLIC: Encoding
+  MACGREEK: Encoding
+  MACICELAND: Encoding
+  MACJAPAN: Encoding
+  MACJAPANESE: Encoding
+  MACROMAN: Encoding
+  MACROMANIA: Encoding
+  MACTHAI: Encoding
+  MACTURKISH: Encoding
+  MACUKRAINE: Encoding
+  MacCentEuro: Encoding
+  MacCroatian: Encoding
+  MacCyrillic: Encoding
+  MacGreek: Encoding
+  MacIceland: Encoding
+  MacJapan: Encoding
+  MacJapanese: Encoding
+  MacRoman: Encoding
+  MacRomania: Encoding
+  MacThai: Encoding
+  MacTurkish: Encoding
+  MacUkraine: Encoding
+  PCK: Encoding
+  SHIFT_JIS: Encoding
+  SJIS: Encoding
+  SJIS_DOCOMO: Encoding
+  SJIS_DoCoMo: Encoding
+  SJIS_KDDI: Encoding
+  SJIS_SOFTBANK: Encoding
+  SJIS_SoftBank: Encoding
+  STATELESS_ISO_2022_JP: Encoding
+  STATELESS_ISO_2022_JP_KDDI: Encoding
+  Shift_JIS: Encoding
+  Stateless_ISO_2022_JP: Encoding
+  Stateless_ISO_2022_JP_KDDI: Encoding
+  TIS_620: Encoding
+  UCS_2BE: Encoding
+  UCS_4BE: Encoding
+  UCS_4LE: Encoding
+  US_ASCII: Encoding
+  UTF8_DOCOMO: Encoding
+  UTF8_DoCoMo: Encoding
+  UTF8_KDDI: Encoding
+  UTF8_MAC: Encoding
+  UTF8_SOFTBANK: Encoding
+  UTF8_SoftBank: Encoding
+  UTF_16: Encoding
+  UTF_16BE: Encoding
+  UTF_16LE: Encoding
+  UTF_32: Encoding
+  UTF_32BE: Encoding
+  UTF_32LE: Encoding
+  UTF_7: Encoding
+  UTF_8: Encoding
+  UTF_8_HFS: Encoding
+  UTF_8_MAC: Encoding
+  WINDOWS_1250: Encoding
+  WINDOWS_1251: Encoding
+  WINDOWS_1252: Encoding
+  WINDOWS_1253: Encoding
+  WINDOWS_1254: Encoding
+  WINDOWS_1255: Encoding
+  WINDOWS_1256: Encoding
+  WINDOWS_1257: Encoding
+  WINDOWS_1258: Encoding
+  WINDOWS_31J: Encoding
+  WINDOWS_874: Encoding
+  Windows_1250: Encoding
+  Windows_1251: Encoding
+  Windows_1252: Encoding
+  Windows_1253: Encoding
+  Windows_1254: Encoding
+  Windows_1255: Encoding
+  Windows_1256: Encoding
+  Windows_1257: Encoding
+  Windows_1258: Encoding
+  Windows_31J: Encoding
+  Windows_874: Encoding
+
+  # <!-- rdoc-file=error.c -->
+  # Raised by Encoding and String methods when the source encoding is incompatible
+  # with the target encoding.
+  #
+  class CompatibilityError < EncodingError
+  end
+
+  # <!-- rdoc-file=transcode.c -->
+  # Raised by transcoding methods when a named encoding does not correspond with a
+  # known converter.
+  #
+  class ConverterNotFoundError < EncodingError
+  end
+
+  # <!-- rdoc-file=transcode.c -->
+  # Raised by Encoding and String methods when the string being transcoded
+  # contains a byte invalid for the either the source or target encoding.
+  #
+  class InvalidByteSequenceError < EncodingError
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.destination_encoding         -> string
+    # -->
+    # Returns the destination encoding as an encoding object.
+    #
+    def destination_encoding: () -> Encoding
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.destination_encoding_name         -> string
+    # -->
+    # Returns the destination encoding name as a string.
+    #
+    def destination_encoding_name: () -> String
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.error_bytes         -> string
+    # -->
+    # Returns the discarded bytes when Encoding::InvalidByteSequenceError occurs.
+    #
+    #     ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1")
+    #     begin
+    #       ec.convert("abc\xA1\xFFdef")
+    #     rescue Encoding::InvalidByteSequenceError
+    #       p $!      #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "\xFF" on EUC-JP>
+    #       puts $!.error_bytes.dump          #=> "\xA1"
+    #       puts $!.readagain_bytes.dump      #=> "\xFF"
+    #     end
+    #
+    def error_bytes: () -> String
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.incomplete_input?         -> true or false
+    # -->
+    # Returns true if the invalid byte sequence error is caused by premature end of
+    # string.
+    #
+    #     ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1")
+    #
+    #     begin
+    #       ec.convert("abc\xA1z")
+    #     rescue Encoding::InvalidByteSequenceError
+    #       p $!      #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "z" on EUC-JP>
+    #       p $!.incomplete_input?    #=> false
+    #     end
+    #
+    #     begin
+    #       ec.convert("abc\xA1")
+    #       ec.finish
+    #     rescue Encoding::InvalidByteSequenceError
+    #       p $!      #=> #<Encoding::InvalidByteSequenceError: incomplete "\xA1" on EUC-JP>
+    #       p $!.incomplete_input?    #=> true
+    #     end
+    #
+    def incomplete_input?: () -> bool
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.readagain_bytes         -> string
+    # -->
+    # Returns the bytes to be read again when Encoding::InvalidByteSequenceError
+    # occurs.
+    #
+    def readagain_bytes: () -> String
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.source_encoding              -> encoding
+    # -->
+    # Returns the source encoding as an encoding object.
+    #
+    # Note that the result may not be equal to the source encoding of the encoding
+    # converter if the conversion has multiple steps.
+    #
+    #     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"
+    #     end
+    #
+    def source_encoding: () -> Encoding
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.source_encoding_name         -> string
+    # -->
+    # Returns the source encoding name as a string.
+    #
+    def source_encoding_name: () -> String
+  end
+
+  # <!-- rdoc-file=transcode.c -->
+  # Raised by Encoding and String methods when a transcoding operation fails.
+  #
+  class UndefinedConversionError < EncodingError
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.destination_encoding         -> string
+    # -->
+    # Returns the destination encoding as an encoding object.
+    #
+    def destination_encoding: () -> Encoding
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.destination_encoding_name         -> string
+    # -->
+    # Returns the destination encoding name as a string.
+    #
+    def destination_encoding_name: () -> String
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.error_char         -> string
+    # -->
+    # Returns the one-character string which cause
+    # Encoding::UndefinedConversionError.
+    #
+    #     ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP")
+    #     begin
+    #       ec.convert("\xa0")
+    #     rescue Encoding::UndefinedConversionError
+    #       puts $!.error_char.dump   #=> "\xC2\xA0"
+    #       p $!.error_char.encoding  #=> #<Encoding:UTF-8>
+    #     end
+    #
+    def error_char: () -> String
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.source_encoding              -> encoding
+    # -->
+    # Returns the source encoding as an encoding object.
+    #
+    # Note that the result may not be equal to the source encoding of the encoding
+    # converter if the conversion has multiple steps.
+    #
+    #     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"
+    #     end
+    #
+    def source_encoding: () -> Encoding
+
+    # <!--
+    #   rdoc-file=transcode.c
+    #   - ecerr.source_encoding_name         -> string
+    # -->
+    # Returns the source encoding name as a string.
+    #
+    def source_encoding_name: () -> String
+  end
 end
 
-Encoding::ANSI_X3_4_1968: Encoding
-
-Encoding::ASCII: Encoding
-
-Encoding::ASCII_8BIT: Encoding
-
-Encoding::BIG5: Encoding
-
-Encoding::BIG5_HKSCS: Encoding
-
-Encoding::BIG5_HKSCS_2008: Encoding
-
-Encoding::BIG5_UAO: Encoding
-
-Encoding::BINARY: Encoding
-
-Encoding::Big5: Encoding
-
-Encoding::Big5_HKSCS: Encoding
-
-Encoding::Big5_HKSCS_2008: Encoding
-
-Encoding::Big5_UAO: Encoding
-
-Encoding::CESU_8: Encoding
-
-Encoding::CP1250: Encoding
-
-Encoding::CP1251: Encoding
-
-Encoding::CP1252: Encoding
-
-Encoding::CP1253: Encoding
-
-Encoding::CP1254: Encoding
-
-Encoding::CP1255: Encoding
-
-Encoding::CP1256: Encoding
-
-Encoding::CP1257: Encoding
-
-Encoding::CP1258: Encoding
-
-Encoding::CP437: Encoding
-
-Encoding::CP50220: Encoding
-
-Encoding::CP50221: Encoding
-
-Encoding::CP51932: Encoding
-
-Encoding::CP65000: Encoding
-
-Encoding::CP65001: Encoding
-
-Encoding::CP737: Encoding
-
-Encoding::CP775: Encoding
-
-Encoding::CP850: Encoding
-
-Encoding::CP852: Encoding
-
-Encoding::CP855: Encoding
-
-Encoding::CP857: Encoding
-
-Encoding::CP860: Encoding
-
-Encoding::CP861: Encoding
-
-Encoding::CP862: Encoding
-
-Encoding::CP863: Encoding
-
-Encoding::CP864: Encoding
-
-Encoding::CP865: Encoding
-
-Encoding::CP866: Encoding
-
-Encoding::CP869: Encoding
-
-Encoding::CP874: Encoding
-
-Encoding::CP878: Encoding
-
-Encoding::CP932: Encoding
-
-Encoding::CP936: Encoding
-
-Encoding::CP949: Encoding
-
-Encoding::CP950: Encoding
-
-Encoding::CP951: Encoding
-
-Encoding::CSWINDOWS31J: Encoding
-
-Encoding::CsWindows31J: Encoding
-
-Encoding::EBCDIC_CP_US: Encoding
-
-Encoding::EMACS_MULE: Encoding
-
-Encoding::EUCCN: Encoding
-
-Encoding::EUCJP: Encoding
-
-Encoding::EUCJP_MS: Encoding
-
-Encoding::EUCKR: Encoding
-
-Encoding::EUCTW: Encoding
-
-Encoding::EUC_CN: Encoding
-
-Encoding::EUC_JISX0213: Encoding
-
-Encoding::EUC_JIS_2004: Encoding
-
-Encoding::EUC_JP: Encoding
-
-Encoding::EUC_JP_MS: Encoding
-
-Encoding::EUC_KR: Encoding
-
-Encoding::EUC_TW: Encoding
-
-Encoding::Emacs_Mule: Encoding
-
-Encoding::EucCN: Encoding
-
-Encoding::EucJP: Encoding
-
-Encoding::EucJP_ms: Encoding
-
-Encoding::EucKR: Encoding
-
-Encoding::EucTW: Encoding
-
-Encoding::GB12345: Encoding
-
-Encoding::GB18030: Encoding
-
-Encoding::GB1988: Encoding
-
-Encoding::GB2312: Encoding
-
-Encoding::GBK: Encoding
-
-Encoding::IBM037: Encoding
-
-Encoding::IBM437: Encoding
-
-Encoding::IBM737: Encoding
-
-Encoding::IBM775: Encoding
-
-Encoding::IBM850: Encoding
-
-Encoding::IBM852: Encoding
-
-Encoding::IBM855: Encoding
-
-Encoding::IBM857: Encoding
-
-Encoding::IBM860: Encoding
-
-Encoding::IBM861: Encoding
-
-Encoding::IBM862: Encoding
-
-Encoding::IBM863: Encoding
-
-Encoding::IBM864: Encoding
-
-Encoding::IBM865: Encoding
-
-Encoding::IBM866: Encoding
-
-Encoding::IBM869: Encoding
-
-Encoding::ISO2022_JP: Encoding
-
-Encoding::ISO2022_JP2: Encoding
-
-Encoding::ISO8859_1: Encoding
-
-Encoding::ISO8859_10: Encoding
-
-Encoding::ISO8859_11: Encoding
-
-Encoding::ISO8859_13: Encoding
-
-Encoding::ISO8859_14: Encoding
-
-Encoding::ISO8859_15: Encoding
-
-Encoding::ISO8859_16: Encoding
-
-Encoding::ISO8859_2: Encoding
-
-Encoding::ISO8859_3: Encoding
-
-Encoding::ISO8859_4: Encoding
-
-Encoding::ISO8859_5: Encoding
-
-Encoding::ISO8859_6: Encoding
-
-Encoding::ISO8859_7: Encoding
-
-Encoding::ISO8859_8: Encoding
-
-Encoding::ISO8859_9: Encoding
-
-Encoding::ISO_2022_JP: Encoding
-
-Encoding::ISO_2022_JP_2: Encoding
-
-Encoding::ISO_2022_JP_KDDI: Encoding
-
-Encoding::ISO_8859_1: Encoding
-
-Encoding::ISO_8859_10: Encoding
-
-Encoding::ISO_8859_11: Encoding
-
-Encoding::ISO_8859_13: Encoding
-
-Encoding::ISO_8859_14: Encoding
-
-Encoding::ISO_8859_15: Encoding
-
-Encoding::ISO_8859_16: Encoding
-
-Encoding::ISO_8859_2: Encoding
-
-Encoding::ISO_8859_3: Encoding
-
-Encoding::ISO_8859_4: Encoding
-
-Encoding::ISO_8859_5: Encoding
-
-Encoding::ISO_8859_6: Encoding
-
-Encoding::ISO_8859_7: Encoding
-
-Encoding::ISO_8859_8: Encoding
-
-Encoding::ISO_8859_9: Encoding
-
-Encoding::KOI8_R: Encoding
-
-Encoding::KOI8_U: Encoding
-
-Encoding::MACCENTEURO: Encoding
-
-Encoding::MACCROATIAN: Encoding
-
-Encoding::MACCYRILLIC: Encoding
-
-Encoding::MACGREEK: Encoding
-
-Encoding::MACICELAND: Encoding
-
-Encoding::MACJAPAN: Encoding
-
-Encoding::MACJAPANESE: Encoding
-
-Encoding::MACROMAN: Encoding
-
-Encoding::MACROMANIA: Encoding
-
-Encoding::MACTHAI: Encoding
-
-Encoding::MACTURKISH: Encoding
-
-Encoding::MACUKRAINE: Encoding
-
-Encoding::MacCentEuro: Encoding
-
-Encoding::MacCroatian: Encoding
-
-Encoding::MacCyrillic: Encoding
-
-Encoding::MacGreek: Encoding
-
-Encoding::MacIceland: Encoding
-
-Encoding::MacJapan: Encoding
-
-Encoding::MacJapanese: Encoding
-
-Encoding::MacRoman: Encoding
-
-Encoding::MacRomania: Encoding
-
-Encoding::MacThai: Encoding
-
-Encoding::MacTurkish: Encoding
-
-Encoding::MacUkraine: Encoding
-
-Encoding::PCK: Encoding
-
-Encoding::SHIFT_JIS: Encoding
-
-Encoding::SJIS: Encoding
-
-Encoding::SJIS_DOCOMO: Encoding
-
-Encoding::SJIS_DoCoMo: Encoding
-
-Encoding::SJIS_KDDI: Encoding
-
-Encoding::SJIS_SOFTBANK: Encoding
-
-Encoding::SJIS_SoftBank: Encoding
-
-Encoding::STATELESS_ISO_2022_JP: Encoding
-
-Encoding::STATELESS_ISO_2022_JP_KDDI: Encoding
-
-Encoding::Shift_JIS: Encoding
-
-Encoding::Stateless_ISO_2022_JP: Encoding
-
-Encoding::Stateless_ISO_2022_JP_KDDI: Encoding
-
-Encoding::TIS_620: Encoding
-
-Encoding::UCS_2BE: Encoding
-
-Encoding::UCS_4BE: Encoding
-
-Encoding::UCS_4LE: Encoding
-
-Encoding::US_ASCII: Encoding
-
-Encoding::UTF8_DOCOMO: Encoding
-
-Encoding::UTF8_DoCoMo: Encoding
-
-Encoding::UTF8_KDDI: Encoding
-
-Encoding::UTF8_MAC: Encoding
-
-Encoding::UTF8_SOFTBANK: Encoding
-
-Encoding::UTF8_SoftBank: Encoding
-
-Encoding::UTF_16: Encoding
-
-Encoding::UTF_16BE: Encoding
-
-Encoding::UTF_16LE: Encoding
-
-Encoding::UTF_32: Encoding
-
-Encoding::UTF_32BE: Encoding
-
-Encoding::UTF_32LE: Encoding
-
-Encoding::UTF_7: Encoding
-
-Encoding::UTF_8: Encoding
-
-Encoding::UTF_8_HFS: Encoding
-
-Encoding::UTF_8_MAC: Encoding
-
-Encoding::WINDOWS_1250: Encoding
-
-Encoding::WINDOWS_1251: Encoding
-
-Encoding::WINDOWS_1252: Encoding
-
-Encoding::WINDOWS_1253: Encoding
-
-Encoding::WINDOWS_1254: Encoding
-
-Encoding::WINDOWS_1255: Encoding
-
-Encoding::WINDOWS_1256: Encoding
-
-Encoding::WINDOWS_1257: Encoding
-
-Encoding::WINDOWS_1258: Encoding
-
-Encoding::WINDOWS_31J: Encoding
-
-Encoding::WINDOWS_874: Encoding
-
-Encoding::Windows_1250: Encoding
-
-Encoding::Windows_1251: Encoding
-
-Encoding::Windows_1252: Encoding
-
-Encoding::Windows_1253: Encoding
-
-Encoding::Windows_1254: Encoding
-
-Encoding::Windows_1255: Encoding
-
-Encoding::Windows_1256: Encoding
-
-Encoding::Windows_1257: Encoding
-
-Encoding::Windows_1258: Encoding
-
-Encoding::Windows_31J: Encoding
-
-Encoding::Windows_874: Encoding
-
 # <!-- rdoc-file=transcode.c -->
 # Encoding conversion class.
 #
@@ -950,8 +780,6 @@ class Encoding::Converter < Object
                               ?xml: :text | :attr
                             ) -> conversion_path
 
-  public
-
   # <!--
   #   rdoc-file=transcode.c
   #   - ec == other        -> true or false
@@ -1171,7 +999,6 @@ class Encoding::Converter < Object
   #     :partial_input is specified.
   # *   conversion is finished (:finished)
   #
-  #
   # example:
   #     ec = Encoding::Converter.new("UTF-8", "UTF-16BE")
   #     ret = ec.primitive_convert(src="pi", dst="", nil, 100)
@@ -1352,11 +1179,13 @@ class Encoding::Converter < Object
   #       :undef => :replace         # replace undefined conversion
   #       :replace => string         # replacement string ("?" or "\uFFFD" if not specified)
   #       :newline => :universal     # decorator for converting CRLF and CR to LF
+  #       :newline => :lf            # decorator for converting CRLF and CR to LF when writing
   #       :newline => :crlf          # decorator for converting LF to CRLF
   #       :newline => :cr            # decorator for converting LF to CR
   #       :universal_newline => true # decorator for converting CRLF and CR to LF
   #       :crlf_newline => true      # decorator for converting LF to CRLF
   #       :cr_newline => true        # decorator for converting LF to CR
+  #       :lf_newline => true        # decorator for converting CRLF and CR to LF when writing
   #       :xml => :text              # escape as XML CharData.
   #       :xml => :attr              # escape as XML AttValue
   #     integer form:
@@ -1364,6 +1193,7 @@ class Encoding::Converter < Object
   #       Encoding::Converter::UNDEF_REPLACE
   #       Encoding::Converter::UNDEF_HEX_CHARREF
   #       Encoding::Converter::UNIVERSAL_NEWLINE_DECORATOR
+  #       Encoding::Converter::LF_NEWLINE_DECORATOR
   #       Encoding::Converter::CRLF_NEWLINE_DECORATOR
   #       Encoding::Converter::CR_NEWLINE_DECORATOR
   #       Encoding::Converter::XML_TEXT_DECORATOR
@@ -1381,7 +1211,6 @@ class Encoding::Converter < Object
   # *   two-element arrays which contain encodings or encoding names, or
   # *   strings representing decorator names.
   #
-  #
   # Encoding::Converter.new optionally takes an option. The option should be a
   # hash or an integer. The option hash can contain :invalid => nil, etc. The
   # option integer should be logical-or of constants such as
@@ -1389,23 +1218,34 @@ class Encoding::Converter < Object
   #
   # :invalid => nil
   # :   Raise error on invalid byte sequence.  This is a default behavior.
+  #
   # :invalid => :replace
   # :   Replace invalid byte sequence by replacement string.
+  #
   # :undef => nil
   # :   Raise an error if a character in source_encoding is not defined in
   #     destination_encoding. This is a default behavior.
+  #
   # :undef => :replace
   # :   Replace undefined character in destination_encoding with replacement
   #     string.
+  #
   # :replace => string
   # :   Specify the replacement string. If not specified, "uFFFD" is used for
   #     Unicode encodings and "?" for others.
+  #
   # :universal_newline => true
   # :   Convert CRLF and CR to LF.
+  #
   # :crlf_newline => true
   # :   Convert LF to CRLF.
+  #
   # :cr_newline => true
   # :   Convert LF to CR.
+  #
+  # :lf_newline => true
+  # :   Convert CRLF and CR to LF (when writing).
+  #
   # :xml => :text
   # :   Escape as XML CharData. This form can be used as an HTML 4.0 #PCDATA.
   #     *   '&' -> '&amp;'
@@ -1425,7 +1265,6 @@ class Encoding::Converter < Object
   #         such as &#xHH;
   #
   #
-  #
   # Examples:
   #     # UTF-16BE to UTF-8
   #     ec = Encoding::Converter.new("UTF-16BE", "UTF-8")
@@ -1463,284 +1302,70 @@ class Encoding::Converter < Object
 end
 
 # <!-- rdoc-file=transcode.c -->
-# AFTER_OUTPUT
-#
 # Stop converting after some output is complete but before all of the input was
 # consumed.  See primitive_convert for an example.
 #
 Encoding::Converter::AFTER_OUTPUT: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# CRLF_NEWLINE_DECORATOR
-#
 # Decorator for converting LF to CRLF
 #
 Encoding::Converter::CRLF_NEWLINE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# CR_NEWLINE_DECORATOR
-#
 # Decorator for converting LF to CR
 #
 Encoding::Converter::CR_NEWLINE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# INVALID_MASK
-#
 # Mask for invalid byte sequences
 #
 Encoding::Converter::INVALID_MASK: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# INVALID_REPLACE
-#
 # Replace invalid byte sequences
 #
 Encoding::Converter::INVALID_REPLACE: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# PARTIAL_INPUT
-#
 # Indicates the source may be part of a larger string.  See primitive_convert
 # for an example.
 #
 Encoding::Converter::PARTIAL_INPUT: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNDEF_HEX_CHARREF
-#
 # Replace byte sequences that are undefined in the destination encoding with an
 # XML hexadecimal character reference.  This is valid for XML conversion.
 #
 Encoding::Converter::UNDEF_HEX_CHARREF: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNDEF_MASK
-#
 # Mask for a valid character in the source encoding but no related character(s)
 # in destination encoding.
 #
 Encoding::Converter::UNDEF_MASK: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNDEF_REPLACE
-#
 # Replace byte sequences that are undefined in the destination encoding.
 #
 Encoding::Converter::UNDEF_REPLACE: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# UNIVERSAL_NEWLINE_DECORATOR
-#
 # Decorator for converting CRLF and CR to LF
 #
 Encoding::Converter::UNIVERSAL_NEWLINE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# XML_ATTR_CONTENT_DECORATOR
-#
 # Escape as XML AttValue
 #
 Encoding::Converter::XML_ATTR_CONTENT_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# XML_ATTR_QUOTE_DECORATOR
-#
 # Escape as XML AttValue
 #
 Encoding::Converter::XML_ATTR_QUOTE_DECORATOR: Integer
 
 # <!-- rdoc-file=transcode.c -->
-# XML_TEXT_DECORATOR
-#
 # Escape as XML CharData
 #
 Encoding::Converter::XML_TEXT_DECORATOR: Integer
-
-# <!-- rdoc-file=error.c -->
-# Raised by Encoding and String methods when the source encoding is incompatible
-# with the target encoding.
-#
-class Encoding::CompatibilityError < EncodingError
-end
-
-# <!-- rdoc-file=transcode.c -->
-# Raised by transcoding methods when a named encoding does not correspond with a
-# known converter.
-#
-class Encoding::ConverterNotFoundError < EncodingError
-end
-
-# <!-- rdoc-file=transcode.c -->
-# Raised by Encoding and String methods when the string being transcoded
-# contains a byte invalid for the either the source or target encoding.
-#
-class Encoding::InvalidByteSequenceError < EncodingError
-  public
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.destination_encoding         -> string
-  # -->
-  # Returns the destination encoding as an encoding object.
-  #
-  def destination_encoding: () -> Encoding
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.destination_encoding_name         -> string
-  # -->
-  # Returns the destination encoding name as a string.
-  #
-  def destination_encoding_name: () -> String
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.error_bytes         -> string
-  # -->
-  # Returns the discarded bytes when Encoding::InvalidByteSequenceError occurs.
-  #
-  #     ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1")
-  #     begin
-  #       ec.convert("abc\xA1\xFFdef")
-  #     rescue Encoding::InvalidByteSequenceError
-  #       p $!      #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "\xFF" on EUC-JP>
-  #       puts $!.error_bytes.dump          #=> "\xA1"
-  #       puts $!.readagain_bytes.dump      #=> "\xFF"
-  #     end
-  #
-  def error_bytes: () -> String
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.incomplete_input?         -> true or false
-  # -->
-  # Returns true if the invalid byte sequence error is caused by premature end of
-  # string.
-  #
-  #     ec = Encoding::Converter.new("EUC-JP", "ISO-8859-1")
-  #
-  #     begin
-  #       ec.convert("abc\xA1z")
-  #     rescue Encoding::InvalidByteSequenceError
-  #       p $!      #=> #<Encoding::InvalidByteSequenceError: "\xA1" followed by "z" on EUC-JP>
-  #       p $!.incomplete_input?    #=> false
-  #     end
-  #
-  #     begin
-  #       ec.convert("abc\xA1")
-  #       ec.finish
-  #     rescue Encoding::InvalidByteSequenceError
-  #       p $!      #=> #<Encoding::InvalidByteSequenceError: incomplete "\xA1" on EUC-JP>
-  #       p $!.incomplete_input?    #=> true
-  #     end
-  #
-  def incomplete_input?: () -> bool
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.readagain_bytes         -> string
-  # -->
-  # Returns the bytes to be read again when Encoding::InvalidByteSequenceError
-  # occurs.
-  #
-  def readagain_bytes: () -> String
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.source_encoding              -> encoding
-  # -->
-  # Returns the source encoding as an encoding object.
-  #
-  # Note that the result may not be equal to the source encoding of the encoding
-  # converter if the conversion has multiple steps.
-  #
-  #     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"
-  #     end
-  #
-  def source_encoding: () -> Encoding
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.source_encoding_name         -> string
-  # -->
-  # Returns the source encoding name as a string.
-  #
-  def source_encoding_name: () -> String
-end
-
-# <!-- rdoc-file=transcode.c -->
-# Raised by Encoding and String methods when a transcoding operation fails.
-#
-class Encoding::UndefinedConversionError < EncodingError
-  public
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.destination_encoding         -> string
-  # -->
-  # Returns the destination encoding as an encoding object.
-  #
-  def destination_encoding: () -> Encoding
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.destination_encoding_name         -> string
-  # -->
-  # Returns the destination encoding name as a string.
-  #
-  def destination_encoding_name: () -> String
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.error_char         -> string
-  # -->
-  # Returns the one-character string which cause
-  # Encoding::UndefinedConversionError.
-  #
-  #     ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP")
-  #     begin
-  #       ec.convert("\xa0")
-  #     rescue Encoding::UndefinedConversionError
-  #       puts $!.error_char.dump   #=> "\xC2\xA0"
-  #       p $!.error_char.encoding  #=> #<Encoding:UTF-8>
-  #     end
-  #
-  def error_char: () -> String
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.source_encoding              -> encoding
-  # -->
-  # Returns the source encoding as an encoding object.
-  #
-  # Note that the result may not be equal to the source encoding of the encoding
-  # converter if the conversion has multiple steps.
-  #
-  #     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"
-  #     end
-  #
-  def source_encoding: () -> Encoding
-
-  # <!--
-  #   rdoc-file=transcode.c
-  #   - ecerr.source_encoding_name         -> string
-  # -->
-  # Returns the source encoding name as a string.
-  #
-  def source_encoding_name: () -> String
-end