W3cubDocs

/Crystal

class CSV::Builder

Overview

A CSV Builder writes CSV to an IO.

require "csv"

result = CSV.build do |csv|
  # A row can be written by specifying several values
  csv.row "Hello", 1, 'a', "String with \"quotes\"", '"', :sym

  # Or an enumerable
  csv.row [1, 2, 3]

  # Or using a block, and appending to the row
  csv.row do |row|
    # Appending a single value
    row << 4

    # Or multiple values
    row.concat 5, 6

    # Or an enumerable
    row.concat [7, 8]
  end
end
puts result

Output:

Hello,1,a,"String with ""quotes""","""",sym
1,2,3
4,5,6,7,8

Defined in:

csv/builder.cr

Constructors

Instance Method Summary

Constructor Detail

def self.new(io : IO, separator : Char = DEFAULT_SEPARATOR, quote_char : Char = DEFAULT_QUOTE_CHAR, quoting : Quoting = Quoting::RFC)Source

Creates a builder that will write to the given IO.

Instance Method Detail

def row(&)Source

Yields a CSV::Row to append a row. A newline is appended to IO after the block exits.

def row(values : Enumerable)Source

Appends the given values as a single row, and then a newline.

def row(*values)Source

Appends the given values as a single row, and then a newline.

© 2012–2020 Manas Technology Solutions.
Licensed under the Apache License, Version 2.0.
https://crystal-lang.org/api/0.35.1/CSV/Builder.html