Merge pull request #516 from jstepien/array-shuffle

Array#shuffle without arguments

lib-topaz/array.rb

@@ -309,4 +309,18 @@ def rotate(n = 1)
     Array.new(self).rotate!(n)
   end
 
+  def shuffle!
+    raise RuntimeError.new("can't modify frozen #{self.class}") if frozen?
+    (self.length - 1).downto(1) do |idx|
+      other = rand(idx + 1)
+      self[other], self[idx] = self[idx], self[other]
+    end
+    self
+  end
+
+  def shuffle
+    arr = Array.new(self)
+    arr.shuffle!
+    arr
+  end
 end

spec/tags/core/array/shuffle_tags.txt

@@ -1,8 +1,3 @@
-fails:Array#shuffle returns the same values, in a usually different order
-fails:Array#shuffle is not destructive
-fails:Array#shuffle does not return subclass instances with Array subclass
-fails:Array#shuffle! returns the same values, in a usually different order
-fails:Array#shuffle! raises a RuntimeError on a frozen array
 fails:Array#shuffle attempts coercion via #to_hash
 fails:Array#shuffle uses default random generator
 fails:Array#shuffle uses given random generator