Ruby CSV.new用法及代码示例

new(string)

new(io)

new(string, **options)

new(io, **options)

返回使用 string 或 io 和指定的 options 创建的新 CSV 对象。

• 参数string 应该是一个字符串对象；它将被放入位于开头的新 StringIO 对象中。

• 参数 io 应该是一个 IO 对象，即：

  • 开放阅读；返回时， IO 对象将被关闭。

  • 定位在开头。要定位在末尾，要追加，请使用方法 CSV.generate 。对于任何其他定位，请改为传递预设的 StringIO 对象。

• 参数options：见：

  • 解析选项

  • 生成选项

  出于性能原因，不能在 CSV 对象中覆盖这些选项，因此此处指定的选项将继续存在。

除了 CSV 实例方法之外，还委托了多个 IO 方法。请参阅委托方法。

从 String 对象创建 CSV 对象：

csv = CSV.new('foo,0')
csv # => #<CSV io_type:StringIO encoding:UTF-8 lineno:0 col_sep:"," row_sep:"\n" quote_char:"\"">

从 File 对象创建 CSV 对象：

File.write('t.csv', 'foo,0')
csv = CSV.new(File.open('t.csv'))
csv # => #<CSV io_type:File io_path:"t.csv" encoding:UTF-8 lineno:0 col_sep:"," row_sep:"\n" quote_char:"\"">

如果参数是 nil 则引发异常：

# Raises ArgumentError (Cannot parse nil as CSV):
CSV.new(nil)