1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00

Moved Array#sample to rbinc

This commit is contained in:
Nobuyoshi Nakada 2020-01-26 18:34:18 +09:00
parent 29eb1b1602
commit d4e1d4e94e
No known key found for this signature in database
GPG key ID: 4BC7D6DF58D8DF60
3 changed files with 45 additions and 62 deletions

View file

@ -33,4 +33,31 @@ class Array
def shuffle(random: Random)
__builtin_rb_ary_shuffle(random);
end
# call-seq:
# ary.sample -> obj
# ary.sample(random: rng) -> obj
# ary.sample(n) -> new_ary
# ary.sample(n, random: rng) -> new_ary
#
# Choose a random element or +n+ random elements from the array.
#
# The elements are chosen by using random and unique indices into the array
# in order to ensure that an element doesn't repeat itself unless the array
# already contained duplicate elements.
#
# If the array is empty the first form returns +nil+ and the second form
# returns an empty array.
#
# a = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
# a.sample #=> 7
# a.sample(4) #=> [6, 4, 2, 5]
#
# The optional +rng+ argument will be used as the random number generator.
#
# a.sample(random: Random.new(1)) #=> 6
# a.sample(4, random: Random.new(1)) #=> [6, 10, 9, 2]
def sample(n = (ary = false), random: Random)
__builtin_rb_ary_sample(random, n, ary)
end
end