instance method `===`

Ruby on Rails 7.2.3

Since v6.0.6

Available in: v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

===(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.

Parameters

value req

Source

# 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

Defined in activesupport/lib/active_support/core_ext/range/compare_range.rb line 16 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveSupport::CompareWithRange

Signature

Parameters