iconv wrapper
C Ruby
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ext/iconv
lib
test Support Ruby 1.8 fix GH-1 Feb 15, 2013
.gitignore Fix for travis-ci Feb 14, 2013
.travis.yml
BSDL Add ext/iconv. Feb 14, 2013
Gemfile
LICENSE.txt Add ext/iconv. Feb 14, 2013
README.md Fix typos Feb 13, 2017
Rakefile
iconv.gemspec The repo has been moved under ruby organization Nov 10, 2016

README.md

Iconv

Build Status

iconv wrapper, used to be ext/iconv

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.

Which coding systems are available is platform-dependent.

Installation

Add this line to your application's Gemfile:

gem 'iconv'

And then execute:

$ bundle

Or install it yourself as:

$ gem install iconv

Usage

  1. Simple conversion between two charsets.

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

  2. 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

  3. Invoke Iconv.open with a block.

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

  4. Shorthand for (3).

    Iconv.iconv(to, from, *input.to_a)

Attentions

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.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

Ruby License/2-clause BSDL