class Range - activesupport-4.2.4 Documentation

# class Range

### Constants

RANGE_FORMATS

### Public Instance Methods

include_with_range?(value) click to toggle source

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

    # File lib/active_support/core_ext/range/include_range.rb, line 12
    def include_with_range?(value)
      if value.is_a?(::Range)
        # 1...10 includes 1..9 but it does not include 1..10.
        operator = exclude_end? && !value.exclude_end? ? :< : :<=
        include_without_range?(value.first) && value.last.send(operator, last)
      else
        include_without_range?(value)
      end
    end

overlaps?(other) click to toggle source

Compare two ranges and see if they overlap each other

    (1..5).overlaps?(4..6) # => true
    (1..5).overlaps?(7..9) # => false

    # File lib/active_support/core_ext/range/overlaps.rb, line 5
    def overlaps?(other)
      cover?(other.first) || other.cover?(first)
    end

to_default_s(format = :default)
Alias for: to_s
to_formatted_s(format = :default) click to toggle source

Gives a human readable format of the range.

    (1..100).to_formatted_s # => "1..100"

    # File lib/active_support/core_ext/range/conversions.rb, line 9
    def to_formatted_s(format = :default)
      if formatter = RANGE_FORMATS[format]
        formatter.call(first, last)
      else
        to_default_s
      end
    end

Also aliased as: to_s
to_s(format = :default)
Also aliased as: to_default_s
Alias for: to_formatted_s