Contents

require 'facet/array/rotate%21'

class Array

  # Rotates an array's elements from back to front n times.
  #
  #   require 'facet/array/rotate'
  #
  #   [1,2,3].rotate      #=> [3,1,2]
  #   [3,1,2].rotate      #=> [2,3,1]
  #   [3,1,2].rotate      #=> [1,2,3]
  #   [1,2,3].rotate(3)   #=> [1,2,3]
  #
  # A negative parameter reverses the order from front to back.
  #
  #   [1,2,3].rotate(-1)  #=> [2,3,1]
  #
  def rotate(n=1)
    self.dup.rotate!(n)
  end
  
end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
facets-0.7.0	lib/facet/array/rotate.rb
facets-0.7.1	lib/facet/array/rotate.rb
facets-0.7.2	lib/facet/array/rotate.rb