Class: Range
Constant Summary
-
RANGE_FORMATS =
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 2{ :db => Proc.new { |start, stop| "BETWEEN '#{start.to_s(:db)}' AND '#{stop.to_s(:db)}'" } }
Instance Method Summary
-
#include_with_range?(value) ⇒ Boolean
Extends the default
Range#include?
to support range comparisons. -
#overlaps?(other) ⇒ Boolean
Compare two ranges and see if they overlap each other (1..5).overlaps?(4..6) # => true (1..5).overlaps?(7..9) # => false.
- #to_default_s
-
#to_formatted_s(format = :default)
(also: #to_s)
Gives a human readable format of the range.
-
#to_s(format = :default)
Alias for #to_formatted_s.
Instance Method Details
#include_with_range?(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?(2..6) # => false
The native Range#include?
behavior is untouched.
('a'..'f').include?('c') # => true
(5..9).include?(11) # => false
# File 'activesupport/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) ⇒ Boolean
Compare two ranges and see if they overlap each other
(1..5).overlaps?(4..6) # => true
(1..5).overlaps?(7..9) # => false
# File 'activesupport/lib/active_support/core_ext/range/overlaps.rb', line 5
def overlaps?(other) cover?(other.first) || other.cover?(first) end
#to_default_s
[ GitHub ]# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 17
alias_method :to_default_s, :to_s
#to_formatted_s(format = :default) Also known as: #to_s
Gives a human readable format of the range.
(1..100).to_formatted_s # => "1..100"
# File 'activesupport/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
#to_s(format = :default)
Alias for #to_formatted_s.
# File 'activesupport/lib/active_support/core_ext/range/conversions.rb', line 18
alias_method :to_s, :to_formatted_s