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)