Methods

Instance Public methods

_empty_range?(b, e, excl)

📝 Source code
# File activesupport/lib/active_support/core_ext/range/overlap.rb, line 31
    def _empty_range?(b, e, excl)
      return false if b.nil? || e.nil?

      comp = b <=> e
      comp.nil? || comp > 0 || (comp == 0 && excl)
    end
🔎 See on GitHub

overlap?(other)

Compare two ranges and see if they overlap each other

(1..5).overlap?(4..6) # => true
(1..5).overlap?(7..9) # => false
Also aliased as: overlaps?
📝 Source code
# File activesupport/lib/active_support/core_ext/range/overlap.rb, line 8
    def overlap?(other)
      raise TypeError unless other.is_a? Range

      self_begin = self.begin
      other_end = other.end
      other_excl = other.exclude_end?

      return false if _empty_range?(self_begin, other_end, other_excl)

      other_begin = other.begin
      self_end = self.end
      self_excl = self.exclude_end?

      return false if _empty_range?(other_begin, self_end, self_excl)
      return true if self_begin == other_begin

      return false if _empty_range?(self_begin, self_end, self_excl)
      return false if _empty_range?(other_begin, other_end, other_excl)

      true
    end
🔎 See on GitHub

overlaps?(other)

Alias for: overlap?

sole()

Returns the sole item in the range. If there are no items, or more than one item, raises Enumerable::SoleItemExpectedError.

(1..1).sole   # => 1
(2..1).sole   # => Enumerable::SoleItemExpectedError: no item found
(..1).sole    # => Enumerable::SoleItemExpectedError: infinite range cannot represent a sole item
📝 Source code
# File activesupport/lib/active_support/core_ext/range/sole.rb, line 10
  def sole
    if self.begin.nil? || self.end.nil?
      raise ActiveSupport::EnumerableCoreExt::SoleItemExpectedError, "infinite range '#{inspect}' cannot represent a sole item"
    end

    super
  end
🔎 See on GitHub