?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.46 KB

//proc/thread-self/root/opt/alt/ruby34/share/gems/gems/csv-3.3.2/doc/csv/options/parsing/converters.rdoc

Text Base64

====== Option +converters+

Specifies converters to be used in parsing fields.
See {Field Converters}[#class-CSV-label-Field+Converters]

Default value:
  CSV::DEFAULT_OPTIONS.fetch(:converters) # => nil

The value may be a field converter name
(see {Stored Converters}[#class-CSV-label-Stored+Converters]):
  str = '1,2,3'
  # Without a converter
  array = CSV.parse_line(str)
  array # => ["1", "2", "3"]
  # With built-in converter :integer
  array = CSV.parse_line(str, converters: :integer)
  array # => [1, 2, 3]

The value may be a converter list
(see {Converter Lists}[#class-CSV-label-Converter+Lists]):
  str = '1,3.14159'
  # Without converters
  array = CSV.parse_line(str)
  array # => ["1", "3.14159"]
  # With built-in converters
  array = CSV.parse_line(str, converters: [:integer, :float])
  array # => [1, 3.14159]

The value may be a \Proc custom converter:
(see {Custom Field Converters}[#class-CSV-label-Custom+Field+Converters]):
  str = ' foo  ,  bar  ,  baz  '
  # Without a converter
  array = CSV.parse_line(str)
  array # => [" foo  ", "  bar  ", "  baz  "]
  # With a custom converter
  array = CSV.parse_line(str, converters: proc {|field| field.strip })
  array # => ["foo", "bar", "baz"]

See also {Custom Field Converters}[#class-CSV-label-Custom+Field+Converters]

---

Raises an exception if the converter is not a converter name or a \Proc:
  str = 'foo,0'
  # Raises NoMethodError (undefined method `arity' for nil:NilClass)
  CSV.parse(str, converters: :foo)

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
converters.rdoc	1.46 KB	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
empty_value.rdoc	400 B	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
field_size_limit.rdoc	1.16 KB	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
headers.rdoc	1.44 KB	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
header_converters.rdoc	1.44 KB	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
liberal_parsing.rdoc	1.50 KB	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
nil_value.rdoc	351 B	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
return_headers.rdoc	568 B	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
skip_blanks.rdoc	784 B	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
skip_lines.rdoc	1.06 KB	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
strip.rdoc	363 B	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive
unconverted_fields.rdoc	976 B	lrw-r--r--	2026-04-20 12:16:12	Edit Download recursive recursive

Directory Contents