Exception: Encoding::InvalidByteSequenceError
- Inherits:
-
EncodingError
- Object
- Exception
- StandardError
- EncodingError
- Encoding::InvalidByteSequenceError
- Defined in:
- transcode.c
Overview
Raised by Encoding and String methods when the string being transcoded contains a byte invalid for the either the source or target encoding.
Instance Method Summary collapse
-
#destination_encoding ⇒ String
Returns the destination encoding as an encoding object.
-
#destination_encoding_name ⇒ String
Returns the destination encoding name as a string.
-
#error_bytes ⇒ String
Returns the discarded bytes when Encoding::InvalidByteSequenceError occurs.
-
#incomplete_input? ⇒ Boolean
Returns true if the invalid byte sequence error is caused by premature end of string.
-
#readagain_bytes ⇒ String
Returns the bytes to be read again when Encoding::InvalidByteSequenceError occurs.
-
#source_encoding ⇒ Encoding
Returns the source encoding as an encoding object.
-
#source_encoding_name ⇒ String
Returns the source encoding name as a string.
Methods inherited from Exception
#==, #backtrace, #exception, exception, #initialize, #inspect, #message, #set_backtrace, #to_s
Constructor Details
This class inherits a constructor from Exception
Instance Method Details
#destination_encoding ⇒ String
Returns the destination encoding as an encoding object.
|
# File 'transcode.c'
/*
* call-seq:
* ecerr.destination_encoding -> string
*
* Returns the destination encoding as an encoding object.
*/
static VALUE
ecerr_destination_encoding(VALUE self)
{
return rb_attr_get(self, rb_intern("destination_encoding"));
}
|
#destination_encoding_name ⇒ String
Returns the destination encoding name as a string.
|
# File 'transcode.c'
/*
* call-seq:
* ecerr.destination_encoding_name -> string
*
* Returns the destination encoding name as a string.
*/
static VALUE
ecerr_destination_encoding_name(VALUE self)
{
return rb_attr_get(self, rb_intern("destination_encoding_name"));
}
|
#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
|
# File 'transcode.c'
/*
* call-seq:
* 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
*/
static VALUE
ecerr_error_bytes(VALUE self)
{
return rb_attr_get(self, rb_intern("error_bytes"));
}
|
#incomplete_input? ⇒ Boolean
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
|
# File 'transcode.c'
/*
* call-seq:
* 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
*/
static VALUE
ecerr_incomplete_input(VALUE self)
{
return rb_attr_get(self, rb_intern("incomplete_input"));
}
|
#readagain_bytes ⇒ String
Returns the bytes to be read again when Encoding::InvalidByteSequenceError occurs.
|
# File 'transcode.c'
/*
* call-seq:
* ecerr.readagain_bytes -> string
*
* Returns the bytes to be read again when Encoding::InvalidByteSequenceError occurs.
*/
static VALUE
ecerr_readagain_bytes(VALUE self)
{
return rb_attr_get(self, rb_intern("readagain_bytes"));
}
|
#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
|
# File 'transcode.c'
/*
* call-seq:
* 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
*
*/
static VALUE
ecerr_source_encoding(VALUE self)
{
return rb_attr_get(self, rb_intern("source_encoding"));
}
|
#source_encoding_name ⇒ String
Returns the source encoding name as a string.
|
# File 'transcode.c'
/*
* call-seq:
* ecerr.source_encoding_name -> string
*
* Returns the source encoding name as a string.
*/
static VALUE
ecerr_source_encoding_name(VALUE self)
{
return rb_attr_get(self, rb_intern("source_encoding_name"));
}
|