summaryrefslogtreecommitdiff
path: root/doc/csv/skip_blanks.rdoc
blob: 2c8f7b7bb85a8484c8b55cd10c2fe231e209c9de (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
====== Option +skip_blanks+

Specifies a boolean that determines whether blank lines in the input will be ignored;
a line that contains a column separator is not considered to be blank.

Default value:
  CSV::DEFAULT_OPTIONS.fetch(:skip_blanks) # => false

See also option {skiplines}[#class-CSV-label-Option+skip_lines].

For examples in this section:
  str = <<-EOT
  foo,0

  bar,1
  baz,2

  ,
  EOT

Using the default, +false+:
  ary = CSV.parse(str)
  ary # => [["foo", "0"], [], ["bar", "1"], ["baz", "2"], [], [nil, nil]]

Using +true+:
  ary = CSV.parse(str, skip_blanks: true)
  ary # => [["foo", "0"], ["bar", "1"], ["baz", "2"], [nil, nil]]

Using a truthy value:
  ary = CSV.parse(str, skip_blanks: :foo)
  ary # => [["foo", "0"], ["bar", "1"], ["baz", "2"], [nil, nil]]