■ ri
---------------------------------------------------- Class: Iconv < Data
Summary
-------
Ruby extension for charset conversion.
Abstract
--------
Iconv is a wrapper class for the UNIX 95 iconv() function family,
which translates string between various encoding systems.
See Open Group's on-line documents for more details.
* iconv.h :
http://www.opengroup.org/onlinepubs/007908799/xsh/iconv.h.html
* iconv_open() :
http://www.opengroup.org/onlinepubs/007908799/xsh/iconv_open.ht
ml
* iconv() :
http://www.opengroup.org/onlinepubs/007908799/xsh/iconv.html
* iconv_close() :
http://www.opengroup.org/onlinepubs/007908799/xsh/iconv_close.h
tml
Which coding systems are available is platform-dependent.
Examples
--------
1. Instantiate a new Iconv and use method Iconv#iconv.
cd = Iconv.new(to, from)
begin
input.each { |s| output << cd.iconv(s) }
output << cd.iconv(nil) # Don't forget this!
ensure
cd.close
end
2. Invoke Iconv.open with a block.
Iconv.open(to, from) do |cd|
input.each { |s| output << cd.iconv(s) }
output << cd.iconv(nil)
end
3. Shorthand for (2).
Iconv.iconv(to, from, *input.to_a)
4. Simple conversion between two charsets.
converted_text = Iconv.new('iso-8859-15', 'utf-8').iconv(text)
------------------------------------------------------------------------
Class methods:
--------------
charset_map, conv, iconv, new, open
Instance methods:
-----------------
close, iconv