Sha256: 833b59ac0d04d00e4d76c86cd0fc0280038320c8b543d67be0675b685bd1d7e2

Contents?: true

Size: 826 Bytes

Versions: 7

Compression:

Stored size: 826 Bytes

Contents

class Array

  # Rotates an array's elements from back to front n times.
  #
  #   [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]
  #
  #  CREDIT: Florian Gross
  #  CREDIT: Thomas Sawyer

  def rotate(n=1)
    self.dup.rotate!(n)
  end

  # Same as #rotate, but acts in place.
  #
  #   a = [1,2,3]
  #   a.rotate!
  #   a  #=> [3,1,2]
  #
  #  CREDIT: Florian Gross
  #  CREDIT: Thomas Sawyer

  def rotate!(n=1)
    n = n.to_int
    return self if (n == 0 or self.empty?)
    if n > 0
      n.abs.times{ self.unshift( self.pop ) }
    else
      n.abs.times{ self.push( self.shift ) }
    end
    self
  end

end

Version data entries

7 entries across 7 versions & 2 rubygems

Version Path
facets-2.4.0 lib/facets/array/rotate.rb
facets-2.4.1 lib/facets/array/rotate.rb
facets-2.4.4 lib/core/facets/array/rotate.rb
facets-2.4.2 lib/core/facets/array/rotate.rb
facets-2.4.3 lib/core/facets/array/rotate.rb
facets-2.4.5 lib/core/facets/array/rotate.rb
mack-facets-0.8.2 lib/gems/facets-2.4.5/lib/core/facets/array/rotate.rb