ruby1.9 csv

# I'm sure I'll miss something, but I'll try to mention most of the major

 
# differences I am aware of, to help others quickly get up to speed:

 
#

 
# === CSV Parsing

 
#

 
# * This parser is m17n aware.  See CSV for full details.

 
# * This library has a stricter parser and will throw MalformedCSVErrors on

 
#   problematic data.

 
# * This library has a less liberal idea of a line ending than CSV.  What you

 
#   set as the <tt>:row_sep</tt> is law.  It can auto-detect your line endings

 
#   though.

 
# * The old library returned empty lines as <tt>[nil]</tt>.  This library calls

 
#   them <tt>[]</tt>.

 
# * This library has a much faster parser.

 
#

 
# === Interface

 
#

 
# * CSV now uses Hash-style parameters to set options.

 
# * CSV no longer has generate_row() or parse_row().

 
# * The old CSV's Reader and Writer classes have been dropped.

 
# * CSV::open() is now more like Ruby's open().

 
# * CSV objects now support most standard IO methods.

 
# * CSV now has a new() method used to wrap objects like String and IO for

 
#   reading and writing.

 
# * CSV::generate() is different from the old method.

 
# * CSV no longer supports partial reads.  It works line-by-line.

 
# * CSV no longer allows the instance methods to override the separators for

 
#   performance reasons.  They must be set in the constructor.
 
 
 
 

# === To a File

 
#

 
#   CSV.open("path/to/file.csv", "wb") do |csv|

 
#     csv << ["row", "of", "CSV", "data"]

 
#     csv << ["another", "row"]

 
#     # ...

 
#   end