class

Iconv

Ruby latest stable (v2_5_5) - 0 notes - Superclass: Data

Class deprecated or moved

This class is deprecated or moved on the latest stable version. The last existing version (v1_9_3_392) is shown here.

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.html
iconv(): http://www.opengroup.org/onlinepubs/007908799/xsh/iconv.html
iconv_close(): http://www.opengroup.org/onlinepubs/007908799/xsh/iconv_close.html

Which coding systems are available is platform-dependent.

Examples

Simple conversion between two charsets.

converted_text = Iconv.conv('iso-8859-15', 'utf-8', text)

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

Invoke Iconv.open with a block.

Iconv.open(to, from) do |cd|
  input.each { |s| output << cd.iconv(s) }
  output << cd.iconv(nil)
end

Shorthand for (3).
```
Iconv.iconv(to, from, *input.to_a)
```

Attentions

Even if some extentions of implementation dependent are useful, DON’T USE those extentions in libraries and scripts to widely distribute. If you want to use those feature, use String#encode.

Show files where this class is defined (1 file)

ext/iconv/iconv.c