summaryrefslogtreecommitdiff
path: root/doc/csv/options/generating/write_empty_value.rdoc
diff options
context:
space:
mode:
authorBurdette Lamar <BurdetteLamar@Yahoo.com>2020-06-24 16:04:25 -0500
committerNobuyoshi Nakada <nobu@ruby-lang.org>2020-07-20 02:32:53 +0900
commitd9eff306f5806c6a1b79019ec44395e4cc816218 (patch)
treeff5b302f3beba9a165b88d8b95aca8541296d34a /doc/csv/options/generating/write_empty_value.rdoc
parent920a16893ad5b76bcb357d45f2c0b9d91d09268e (diff)
[ruby/csv] Organize files in doc/ (#145)
https://github.com/ruby/csv/commit/bc9ea859b0
Notes
Notes: Merged: https://github.com/ruby/ruby/pull/3332
Diffstat (limited to 'doc/csv/options/generating/write_empty_value.rdoc')
-rw-r--r--doc/csv/options/generating/write_empty_value.rdoc15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/csv/options/generating/write_empty_value.rdoc b/doc/csv/options/generating/write_empty_value.rdoc
new file mode 100644
index 0000000000..67be5662cb
--- /dev/null
+++ b/doc/csv/options/generating/write_empty_value.rdoc
@@ -0,0 +1,15 @@
+====== Option +write_empty_value+
+
+Specifies the object that is to be substituted for each field
+that has an empty \String.
+
+Default value:
+ CSV::DEFAULT_OPTIONS.fetch(:write_empty_value) # => ""
+
+Without the option:
+ str = CSV.generate_line(['a', '', 'c', ''])
+ str # => "a,\"\",c,\"\"\n"
+
+With the option:
+ str = CSV.generate_line(['a', '', 'c', ''], write_empty_value: "x")
+ str # => "a,x,c,x\n"