array.rb: show examples whether `Array#shuffle!` has side effect or not

Partially revert 54fb8fb62a
This commit is contained in:
Yusuke Endoh 2020-11-12 16:56:15 +09:00
Родитель fa3670e6e4
Коммит a02ba60466
1 изменённых файлов: 4 добавлений и 2 удалений

Просмотреть файл

@ -5,6 +5,7 @@ class Array
# Shuffles the elements of +self+ in place.
# a = [1, 2, 3] #=> [1, 2, 3]
# a.shuffle! #=> [2, 3, 1]
# a #=> [2, 3, 1]
#
# The optional +random+ argument will be used as the random number generator:
# a.shuffle!(random: Random.new(1)) #=> [1, 3, 2]
@ -18,6 +19,7 @@ class Array
# Returns a new array with elements of +self+ shuffled.
# a = [1, 2, 3] #=> [1, 2, 3]
# a.shuffle #=> [2, 3, 1]
# a #=> [1, 2, 3]
#
# The optional +random+ argument will be used as the random number generator:
# a.shuffle(random: Random.new(1)) #=> [1, 3, 2]