From d9eff306f5806c6a1b79019ec44395e4cc816218 Mon Sep 17 00:00:00 2001 From: Burdette Lamar Date: Wed, 24 Jun 2020 16:04:25 -0500 Subject: [ruby/csv] Organize files in doc/ (#145) https://github.com/ruby/csv/commit/bc9ea859b0 --- doc/csv/options/parsing/unconverted_fields.rdoc | 27 +++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 doc/csv/options/parsing/unconverted_fields.rdoc (limited to 'doc/csv/options/parsing/unconverted_fields.rdoc') diff --git a/doc/csv/options/parsing/unconverted_fields.rdoc b/doc/csv/options/parsing/unconverted_fields.rdoc new file mode 100644 index 0000000000..3e7f839d49 --- /dev/null +++ b/doc/csv/options/parsing/unconverted_fields.rdoc @@ -0,0 +1,27 @@ +====== Option +unconverted_fields+ + +Specifies the boolean that determines whether unconverted field values are to be available. + +Default value: + CSV::DEFAULT_OPTIONS.fetch(:unconverted_fields) # => nil + +The unconverted field values are those found in the source data, +prior to any conversions performed via option +converters+. + +When option +unconverted_fields+ is +true+, +each returned row (\Array or \CSV::Row) has an added method, ++unconverted_fields+, that returns the unconverted field values: + str = <<-EOT + foo,0 + bar,1 + baz,2 + EOT + # Without unconverted_fields + csv = CSV.parse(str, converters: :integer) + csv # => [["foo", 0], ["bar", 1], ["baz", 2]] + csv.first.respond_to?(:unconverted_fields) # => false + # With unconverted_fields + csv = CSV.parse(str, converters: :integer, unconverted_fields: true) + csv # => [["foo", 0], ["bar", 1], ["baz", 2]] + csv.first.respond_to?(:unconverted_fields) # => true + csv.first.unconverted_fields # => ["foo", "0"] -- cgit v1.2.3