ActiveLdap 1.2.4

[redminele/redminele.git] / ruby / lib / ruby / gems / 1.8 / gems / activesupport-2.3.12 / lib / active_support / core_ext / array / random_access.rb

diff --git a/ruby/lib/ruby/gems/1.8/gems/activesupport-2.3.12/lib/active_support/core_ext/array/random_access.rb b/ruby/lib/ruby/gems/1.8/gems/activesupport-2.3.12/lib/active_support/core_ext/array/random_access.rb
new file mode 100644 (file)
index 0000000..a0ca89f
--- /dev/null
+++ b/ruby/lib/ruby/gems/1.8/gems/activesupport-2.3.12/lib/active_support/core_ext/array/random_access.rb
@@ -0,0 +1,42 @@
+module ActiveSupport #:nodoc:
+  module CoreExtensions #:nodoc:
+    module Array #:nodoc:
+      module RandomAccess
+        # This method is deprecated because it masks Kernel#rand within the Array class itself, 
+        # which may be used by a 3rd party library extending Array in turn. See
+        #
+        #   https://rails.lighthouseapp.com/projects/8994-ruby-on-rails/tickets/4555
+        #
+        def rand # :nodoc:
+          ActiveSupport::Deprecation.warn 'Array#rand is deprecated and will be removed in Rails 3. Use Array#sample instead', caller
+          sample
+        end
+
+        # Returns a random element from the array.
+        def random_element # :nodoc:
+          ActiveSupport::Deprecation.warn 'Array#random_element is deprecated and will be removed in Rails 3. Use Array#sample instead', caller
+          sample
+        end
+
+        # Backport of Array#sample based on Marc-Andre Lafortune's http://github.com/marcandre/backports/
+        def sample(n=nil)
+          return self[Kernel.rand(size)] if n.nil?
+          n = n.to_int
+        rescue Exception => e
+          raise TypeError, "Coercion error: #{n.inspect}.to_int => Integer failed:\n(#{e.message})"
+        else
+          raise TypeError, "Coercion error: #{n}.to_int did NOT return an Integer (was #{n.class})" unless n.kind_of? ::Integer
+          raise ArgumentError, "negative array size" if n < 0
+          n = size if n > size
+          result = ::Array.new(self)
+          n.times do |i|
+            r = i + Kernel.rand(size - i)
+            result[i], result[r] = result[r], result[i]
+          end
+          result[n..size] = []
+          result
+        end unless method_defined? :sample
+      end
+    end
+  end
+end