iconv wrapper, used to be ext/iconv
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.htmliconv_open()
: http://www.opengroup.org/onlinepubs/007908799/xsh/iconv_open.htmliconv()
: http://www.opengroup.org/onlinepubs/007908799/xsh/iconv.htmliconv_close()
: http://www.opengroup.org/onlinepubs/007908799/xsh/iconv_close.html
Which coding systems are available is platform-dependent.
Add this line to your application's Gemfile:
gem 'iconv'
And then execute:
$ bundle
Or install it yourself as:
$ gem install iconv
- Simple conversion between two charsets.
converted_text = Iconv.conv('iso-8859-15', 'utf-8', text)
- Instantiate a new
Iconv
and use methodIconv#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)
Even if some extensions of implementation dependent are useful,
DON'T USE those extensions in libraries and scripts to widely distribute.
If you want to use those feature, use String#encode
.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Ruby License/2-clause BSDL