123456789_123456789_123456789_123456789_123456789_

Class: Range

Constant Summary

::ActiveSupport::RangeWithFormat - Prepended

RANGE_FORMATS

Instance Method Summary

::ActiveSupport::EachTimeWithZone - Prepended

#each, #step, #ensure_iteration_allowed

::ActiveSupport::RangeWithFormat - Prepended

#to_formatted_s

Alias for ActiveSupport::RangeWithFormat#to_fs.
#to_fs

Convert range to a formatted string.

::ActiveSupport::CompareWithRange - Prepended

#===

Extends the default Range#=== to support range comparisons.
#include?

Extends the default Range#include? to support range comparisons.

Instance Method Details

#_empty_range?(b, e, excl) ⇒ Boolean (private)

[ GitHub ] 

  


# 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


  








  

    #as_json(options = nil)  
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/core_ext/object/json.rb', line 158



def as_json(options = nil) # :nodoc:
  to_s
end


  








  

    #overlap?(other)  ⇒ Boolean 
    Also known as: #overlaps?
  



  

    
  





  
Raises:


    
  
  • 
    (TypeError)
  
    • 





  [ GitHub ]


  

  


# 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


  








  

    #overlaps?(other)  
  



  

    

Alias for #overlap?.


  



  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/core_ext/range/overlap.rb', line 39



alias :overlaps? :overlap?


  








  

    #sum(initial_value = 0)  
  

  

    This method is for internal use only.
  



  

    

Optimize range sum to use arithmetic progression if a block is not given and we have a range of numeric values.


  



  [ GitHub ]


  

  


# File 'activesupport/lib/active_support/core_ext/enumerable.rb', line 241



def sum(initial_value = 0)
  if block_given? || !(first.is_a?(Integer) && last.is_a?(Integer))
    super
  else
    actual_last = exclude_end? ? (last - 1) : last
    if actual_last >= first
      sum = initial_value || 0
      sum + (actual_last - first + 1) * (actual_last + first) / 2
    else
      initial_value || 0
    end
  end
end