Module: ActiveSupport::CompareWithRange

Included in:
Range
Defined in:
lib/active_support/core_ext/range/compare_range.rb

Overview

:nodoc:

Instance Method Summary collapse

Instance Method Details

#===(value) ⇒ Object

Extends the default Range#=== to support range comparisons.

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

The native Range#=== behavior is untouched.

('a'..'f') === ('c') # => true
(5..9) === (11) # => false


13
14
15
16
17
18
19
20
21
# File 'lib/active_support/core_ext/range/compare_range.rb', line 13

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

#cover?(value) ⇒ Boolean

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

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

The native Range#cover? behavior is untouched.

('a'..'f').cover?('c') # => true
(5..9).cover?(11) # => false

Returns:

  • (Boolean)


49
50
51
52
53
54
55
56
57
# File 'lib/active_support/core_ext/range/compare_range.rb', line 49

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

#include?(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

Returns:

  • (Boolean)


31
32
33
34
35
36
37
38
39
# File 'lib/active_support/core_ext/range/compare_range.rb', line 31

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