From e79c0a97da339e10222d23c7f49472b0e293b14b Mon Sep 17 00:00:00 2001 From: matz Date: Thu, 16 Jul 2009 05:10:18 +0000 Subject: * array.c (rb_ary_sample): RDoc update. a patch from Florian Frank. [ruby-core:24347] git-svn-id: http://svn.ruby-lang.org/repos/ruby/trunk@24141 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 5 +++++ array.c | 8 +++++--- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/ChangeLog b/ChangeLog index 280cefe89..452411303 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +Thu Jul 16 14:08:44 2009 Yukihiro Matsumoto + + * array.c (rb_ary_sample): RDoc update. a patch from Florian + Frank. [ruby-core:24347] + Thu Jul 16 12:42:10 2009 NARUSE, Yui * ext/readline/readline.c (readline_readline): rl_free_line_state diff --git a/array.c b/array.c index 52981a2b4..b9b60c873 100644 --- a/array.c +++ b/array.c @@ -3526,9 +3526,11 @@ rb_ary_shuffle(VALUE ary) * array.sample -> obj * array.sample(n) -> an_array * - * Choose a random element, or the random +n+ elements, from the array. - * If the array is empty, the first form returns nil, and the - * second form returns an empty array. + * 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. * */ -- cgit