method

cover?

Ruby on Rails latest stable (v6.1.7.7) - 0 notes - Class: CompareWithRange

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1
2.3.8
3.0.0
3.0.9
3.1.0
3.2.1
3.2.8
3.2.13
4.0.2
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7
5.2.3 (0)
6.0.0 (4)
6.1.3.1 (7)
6.1.7.7 (0)
7.0.0
7.1.3.2
What's this?

cover?(value) public

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.

Show source

# 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

cover?

Related methods