CSV methods that allow you to open IO objects ( CSV::foreach(), CSV::open(), CSV::read(), and CSV::readlines()) do allow you to specify the Encoding. It's just too hard for me to support native conversions in all of Ruby's Encodings.Īnyway, the practical side of this is simple: make sure IO and String objects passed into CSV have the proper Encoding set and everything should just work.

Again, you can provide custom converters that are aware of your Encodings to avoid this translation.

For example, the built-in converters will try to transcode data to UTF-8 before making conversions. It's also important to note that while all of CSV's core parser is now Encoding agnostic, some features are not. However, you can set these values manually in the target Encoding to avoid the translation. Hopefully this makes the entire process feel transparent, since CSV's defaults should just magically work for your data. For example, :col_sep, :row_sep, and :quote_char must be transcoded to match your data. Some transcoding must take place, of course, to accomplish this multiencoding support. This is accomplished by transcoding the parser itself into your Encoding. Thus CSV will return Arrays or Rows of Strings in the Encoding of your data. Your data is never transcoded (unless you ask Ruby to transcode it for you) and will literally be parsed in the Encoding it is in. The parser works in the Encoding of the IO or String object being read from or written to. CSV and Character Encodings (M17n or Multilingualization) ¶ ↑ read (with gets() or each()) from and write (with <<) to csv here. parse_csv # from CSV Shortcut Interface ¶ ↑ CSV # from $stdin Advanced Usage ¶ ↑ Wrap an IO Object ¶ ↑ csv = CSV. to_csv # to CSV csv_array = 'CSV,String'. end Convert a Single Line ¶ ↑ csv_string =. open( 'path/to/file.csv', 'wb') do | csv | csv << parse( 'CSV,data,String') do | row | # use row here. read( 'path/to/file.csv')įrom a String ¶ ↑ A Line at a Time ¶ ↑ CSV. foreach( 'path/to/file.csv') do | row | # use row here. Reading ¶ ↑ From a File ¶ ↑ A Line at a Time ¶ ↑ CSV.

It offers tools to enable you to read and write to and from Strings or IO objects, as needed. This class provides a complete interface to CSV files and data.

Encoder Builder 2.4