ec.convert(source_string) â destination_string Instance Public methods Convert source_string and return destination_string. source_string is assumed as a part of source. i.e. :partial_input=>true is specified internally. finish method should be used last. ec = Encoding::Converter.new("utf-8", "euc-jp") puts ec.convert("\u3042").dump #=> "\xA4\xA2" puts ec.finish.dump #=> "" ec = Encoding::Converter.new("euc-jp", "utf-8") puts ec.convert("\xA4").dump

ec.convpath â ary Instance Public methods Returns the conversion path of ec. The result is an array of conversions. ec = Encoding::Converter.new("ISO-8859-1", "EUC-JP", crlf_newline: true) p ec.convpath #=> [[#<Encoding:ISO-8859-1>, #<Encoding:UTF-8>], # [#<Encoding:UTF-8>, #<Encoding:EUC-JP>], # "crlf_newline"] Each element of the array is a pair of encodings or a string. A pair means an encoding conversion. A string means a decorator. In

ec.destination_encoding â encoding Instance Public methods Returns the destination encoding as an Encoding object.

ec.finish â string Instance Public methods Finishes the converter. It returns the last part of the converted string. ec = Encoding::Converter.new("utf-8", "iso-2022-jp") p ec.convert("\u3042") #=> "\e$B$\"" p ec.finish #=> "\e(B"

ec.insert_output(string) â nil Instance Public methods Inserts string into the encoding converter. The string will be converted to the destination encoding and output on later conversions. If the destination encoding is stateful, string is converted according to the state and the state is updated. This method should be used only when a conversion error occurs. ec = Encoding::Converter.new("utf-8", "iso-8859-1") src = "HIRAGANA LETTER A is \u{3042}." dst = "" p ec.primitive_convert

ec.inspect â string Instance Public methods Returns a printable version of ec ec = Encoding::Converter.new("iso-8859-1", "utf-8") puts ec.inspect #=> #<Encoding::Converter: ISO-8859-1 to UTF-8>

ec.last_error â exception or nil Instance Public methods Returns an exception object for the last conversion. Returns nil if the last conversion did not produce an error. âerrorâ means that Encoding::InvalidByteSequenceError and Encoding::UndefinedConversionError for #convert and :invalid_byte_sequence, :incomplete_input and :undefined_conversion for #primitive_convert. ec = Encoding::Converter.new("utf-8", "iso-8859-1") p ec.primitive_convert(src="\xf1abcd", dst="") #=>

ec.primitive_convert(source_buffer, destination_buffer) â symbolec.primitive_convert(source_buffer, destination_buffer, destination_byteoffset) â symbolec.primitive_convert(source_buffer, destination_buffer, destination_byteoffset, destination_bytesize) â symbolec.primitive_convert(source_buffer, destination_buffer, destination_byteoffset, destination_bytesize, opt) â symbol Instance Public methods possible opt elements: hash form: :partial_input => true # source bu

ec.primitive_errinfo â array Instance Public methods #primitive_errinfo returns important information regarding the last error as a 5-element array: [result, enc1, enc2, error_bytes, readagain_bytes] result is the last result of primitive_convert. Other elements are only meaningful when result is :invalid_byte_sequence, :incomplete_input or :undefined_conversion. enc1 and enc2 indicate a conversion step as a pair of strings. For example, a converter from EUC-JP to ISO-8859-1 conv

putback(p1 = v1) Instance Public methods call-seq ec.putback -> string ec.putback(max_numbytes) -> string Put back the bytes which will be converted. The bytes are caused by invalid_byte_sequence error. When invalid_byte_sequence error, some bytes are discarded and some bytes are buffered to be converted later. The latter bytes can be put back. It can be observed by Encoding::InvalidByteSequenceError#readagain_bytes and #primitive_errinfo. ec = Encodin