?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.50 KB

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

Text Base64

====== Option +liberal_parsing+

Specifies the boolean or hash value that determines whether
CSV will attempt to parse input not conformant with RFC 4180,
such as double quotes in unquoted fields.

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

For the next two examples:
  str = 'is,this "three, or four",fields'

Without +liberal_parsing+:
  # Raises CSV::MalformedCSVError (Illegal quoting in str 1.)
  CSV.parse_line(str)

With +liberal_parsing+:
  ary = CSV.parse_line(str, liberal_parsing: true)
  ary # => ["is", "this \"three", " or four\"", "fields"]

Use the +backslash_quote+ sub-option to parse values that use
a backslash to escape a double-quote character.  This
causes the parser to treat <code>\"</code> as if it were
<code>""</code>.

For the next two examples:
  str = 'Show,"Harry \"Handcuff\" Houdini, the one and only","Tampa Theater"'

With +liberal_parsing+, but without the +backslash_quote+ sub-option:
  # Incorrect interpretation of backslash; incorrectly interprets the quoted comma as a field separator.
  ary = CSV.parse_line(str, liberal_parsing: true)
  ary # => ["Show", "\"Harry \\\"Handcuff\\\" Houdini", " the one and only\"", "Tampa Theater"]
  puts ary[1] # => "Harry \"Handcuff\" Houdini

With +liberal_parsing+ and its +backslash_quote+ sub-option:
  ary = CSV.parse_line(str, liberal_parsing: { backslash_quote: true })
  ary # => ["Show", "Harry \"Handcuff\" Houdini, the one and only", "Tampa Theater"]
  puts ary[1] # => Harry "Handcuff" Houdini, the one and only

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