Sha256: 075d97c039b5512734f7b88c908f7ddf4c5b863d863d74a2c7b15eb934467372

Contents?: true

Size: 1.22 KB

Versions: 5

Compression:

Stored size: 1.22 KB

Contents

module ActiveSupport #:nodoc:
  module CoreExtensions #:nodoc:
    module Array #:nodoc:
      # Enables to conversion of Arrays to human readable lists. ['one', 'two', 'three'] => "one, two, and three"
      module Conversions
        # Converts the array to comma-seperated sentence where the last element is joined by the connector word. Options:
        # * <tt>:connector</tt>: The word used to join the last element in arrays with more than two elements (default: "and")
        # * <tt>:skip_last_comma</tt>: Set to true to return "a, b and c" instead of "a, b, and c".
        def to_sentence(options = {})
          options.assert_valid_keys(:connector, :skip_last_comma)
          options.reverse_merge! :connector => 'and', :skip_last_comma => false
          
          case length
            when 1
              self[0]
            when 2
              "#{self[0]} #{options[:connector]} #{self[1]}"
            else
              "#{self[0...-1].join(', ')}#{options[:skip_last_comma] ? '' : ','} #{options[:connector]} #{self[-1]}"
          end
        end

        # When an array is given to url_for, it is converted to a slash separated string.
        def to_param
          join '/'
        end
      end
    end
  end
end

Version data entries

5 entries across 5 versions & 1 rubygems

Version Path
activesupport-1.2.3 lib/active_support/core_ext/array/conversions.rb
activesupport-1.2.2 lib/active_support/core_ext/array/conversions.rb
activesupport-1.2.5 lib/active_support/core_ext/array/conversions.rb
activesupport-1.2.1 lib/active_support/core_ext/array/conversions.rb
activesupport-1.2.4 lib/active_support/core_ext/array/conversions.rb