CSV.generate_line

CSV.generate_line(ary)

CSV.generate_line(ary, **options)

# File tmp/rubies/ruby-3.3.0/lib/csv.rb, line 1446
def generate_line(row, **options)
  options = {row_sep: InputRecordSeparator.value}.merge(options)
  str = +""
  if options[:encoding]
    str.force_encoding(options[:encoding])
  else
    fallback_encoding = nil
    output_encoding = nil
    row.each do |field|
      next unless field.is_a?(String)
      fallback_encoding ||= field.encoding
      next if field.ascii_only?
      output_encoding = field.encoding
      break
    end
    output_encoding ||= fallback_encoding
    if output_encoding
      str.force_encoding(output_encoding)
    end
  end
  (new(str, **options) << row).string
end

Returns the String created by generating CSV from ary using the specified options.

Argument ary must be an Array.

Special options:

Option :row_sep defaults to "\n"> on Ruby 3.0 or later and <tt>$INPUT_RECORD_SEPARATOR ($/) otherwise.:

Example
```
$INPUT_RECORD_SEPARATOR # => "\n"
```
This method accepts an additional option, :encoding, which sets the base Encoding for the output. This method will try to guess your Encoding from the first non-nil field in row, if possible, but you may need to use this parameter as a backup plan.

For other options, see Options for Generating.

Returns the String generated from an Array:

Example

CSV.generate_line(['foo', '0']) # => "foo,0\n"

Raises an exception if ary is not an Array:

Example

# Raises NoMethodError (undefined method `find' for :foo:Symbol)
CSV.generate_line(:foo)

See also .generate .generate_lines .foreach .instance also in 3.2 · 3.1 · 3.0

‹ prev.generate next ›.generate_lines