123456789_123456789_123456789_123456789_123456789_

Module: ActiveSupport::CompareWithRange

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Prepended In:
::Range
Defined in: activesupport/lib/active_support/core_ext/range/compare_range.rb

Instance Method Summary

Instance Method Details

#===(value)

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

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

The native Range#=== behavior is untouched.

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

The given range must be fully bounded, with both start and end.

[ GitHub ] 

  


# File 'activesupport/lib/active_support/core_ext/range/compare_range.rb', line 16



def ===(value)
  if value.is_a?(::Range)
    is_backwards_op = value.exclude_end? ? :>= : :>
    return false if value.begin && value.end && value.begin.public_send(is_backwards_op, value.end)
    # 1...10 includes 1..9 but it does not include 1..10.
    # 1..10 includes 1...11 but it does not include 1...12.
    operator = exclude_end? && !value.exclude_end? ? :< : :<=
    value_max = !exclude_end? && value.exclude_end? ? value.max : value.last
    super(value.first) && (self.end.nil? || value_max.public_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?(1...6) # => true
(1..5).cover?(2..6)  # => false



The native Range#cover? behavior is untouched.



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



The given range must be fully bounded, with both start and end.


  





  


  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/core_ext/range/compare_range.rb', line 66



def cover?(value)
  if value.is_a?(::Range)
    is_backwards_op = value.exclude_end? ? :>= : :>
    return false if value.begin && value.end && value.begin.public_send(is_backwards_op, value.end)
    # 1...10 covers 1..9 but it does not cover 1..10.
    # 1..10 covers 1...11 but it does not cover 1...12.
    operator = exclude_end? && !value.exclude_end? ? :< : :<=
    value_max = !exclude_end? && value.exclude_end? ? value.max : value.last
    super(value.first) && (self.end.nil? || value_max.public_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?(1...6) # => true
(1..5).include?(2..6)  # => false



The native Range#include? behavior is untouched.



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



The given range must be fully bounded, with both start and end.


  





  


  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/core_ext/range/compare_range.rb', line 41



def include?(value)
  if value.is_a?(::Range)
    is_backwards_op = value.exclude_end? ? :>= : :>
    return false if value.begin && value.end && value.begin.public_send(is_backwards_op, value.end)
    # 1...10 includes 1..9 but it does not include 1..10.
    # 1..10 includes 1...11 but it does not include 1...12.
    operator = exclude_end? && !value.exclude_end? ? :< : :<=
    value_max = !exclude_end? && value.exclude_end? ? value.max : value.last
    super(value.first) && (self.end.nil? || value_max.public_send(operator, last))
  else
    super
  end
end