All Projects → ruby → iconv

ruby / iconv

Licence: other
iconv wrapper

Programming Languages

c
50402 projects - #5 most used programming language
ruby
36898 projects - #4 most used programming language

Projects that are alternatives of or similar to iconv

Iconv Lite
Convert character encodings in pure javascript.
Stars: ✭ 2,697 (+4894.44%)
Mutual labels:  iconv
ExIconv
这是一个C语言编码自动解析库
Stars: ✭ 15 (-72.22%)
Mutual labels:  iconv
iconv
Fast encoding conversion library for Erlang / Elixir
Stars: ✭ 45 (-16.67%)
Mutual labels:  iconv
cpputils
various c++ utility classes
Stars: ✭ 19 (-64.81%)
Mutual labels:  iconv
gettext-iconv-windows
gettext and iconv binaries for Windows
Stars: ✭ 106 (+96.3%)
Mutual labels:  iconv

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

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].