123456789_123456789_123456789_123456789_123456789_

Class: Range

Constant Summary

Instance Method Summary

Instance Method Details

#include_with_range?(value) ⇒ Boolean

Extends the default Range#include? to support range comparisons.

(1..5).include?(1..5) # => true
(1..5).include?(2..3) # => true
(1..5).include?(2..6) # => false

The native Range#include? behavior is untouched.

('a'..'f').include?('c') # => true
(5..9).include?(11) # => false
[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/include_range.rb', line 12

def include_with_range?(value)
  if value.is_a?(::Range)
    # 1...10 includes 1..9 but it does not include 1..10.
    operator = exclude_end? && !value.exclude_end? ? :< : :<=
    include_without_range?(value.first) && value.last.send(operator, last)
  else
    include_without_range?(value)
  end
end

#overlaps?(other) ⇒ Boolean

Compare two ranges and see if they overlap each other

(1..5).overlaps?(4..6) # => true
(1..5).overlaps?(7..9) # => false
[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/overlaps.rb', line 5

def overlaps?(other)
  cover?(other.first) || other.cover?(first)
end

#to_default_s

[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 17

alias_method :to_default_s, :to_s

#to_formatted_s(format = :default) Also known as: #to_s

Gives a human readable format of the range.

(1..100).to_formatted_s # => "1..100"
[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 9

def to_formatted_s(format = :default)
  if formatter = RANGE_FORMATS[format]
    formatter.call(first, last)
  else
    to_default_s
  end
end

#to_s(format = :default)

Alias for #to_formatted_s.

[ GitHub ]

  
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 18

alias_method :to_s, :to_formatted_s