method

to_sentence

v2.2.1 - Show latest stable - Class: ActiveSupport::CoreExtensions::Array::Conversions

to_sentence(options = {})

public

Converts the array to a comma-separated sentence where the last element is joined by the connector word. Options:

:connector - The word used to join the last element in arrays with two or more elements (default: "and")
:skip_last_comma - Set to true to return "a, b and c" instead of "a, b, and c".

# File activesupport/lib/active_support/core_ext/array/conversions.rb, line 10
        def to_sentence(options = {})          
          options.assert_valid_keys(:connector, :skip_last_comma, :locale)
          
          default = I18n.translate('support.array.sentence_connector''support.array.sentence_connector', :locale => options[:locale])
          default_skip_last_comma = I18n.translate('support.array.skip_last_comma''support.array.skip_last_comma', :locale => options[:locale])
          options.reverse_merge! :connector => default, :skip_last_comma => default_skip_last_comma
          options[:connector] = "#{options[:connector]} " unless options[:connector].nil? || options[:connector].strip == ''

          case length
            when 0
              ""
            when 1
              self[0].to_s
            when 2
              "#{self[0]} #{options[:connector]}#{self[1]}"
            else
              "#{self[0...-1].join(', ')}#{options[:skip_last_comma] ? '' : ','} #{options[:connector]}#{self[-1]}"
          end
        end

1Note

Valid options changed in Rails v2.3.0 RC1

zoopzoop · Mar 2, 20092 thanks

The valid options in Rails v2.3.0 RC1 are no longer

:connector and :skip_last_comma, but

:words_connector, :two_words_connector, and :last_word_connector:

>> %w(lorem ipsum dolor sit).to_sentence
=> "lorem, ipsum, dolor, and sit"

>> %w(lorem ipsum dolor sit).to_sentence(:words_connector => ' + ')
=> "lorem + ipsum + dolor, and sit"

>> %w(lorem ipsum).to_sentence(:two_words_connector => ' through ')
=> "lorem through ipsum"

# No effect if more than two words
>> %w(lorem ipsum dolor sit).to_sentence(:two_words_connector => ' through ')
=> "lorem, ipsum, dolor, and sit"

>> %w(lorem ipsum dolor sit).to_sentence(:last_word_connector => ' or ')
=> "lorem, ipsum, dolor or sit"

to_sentence

1Note

Valid options changed in Rails v2.3.0 RC1

Related methods