diff --git a/S32-setting-library/Containers.pod b/S32-setting-library/Containers.pod index fb03814bb..a3140063a 100644 --- a/S32-setting-library/Containers.pod +++ b/S32-setting-library/Containers.pod @@ -1033,10 +1033,10 @@ to false. =item grab - our multi method grab ( $bag: Int $num = 1, Bool :$replace ) - our multi method grab ( $bag: Whatever, Bool :$replace ) - our multi method grabpairs ( $bag: Int $num = 1, Bool :$replace ) - our multi method grabpairs ( $bag: Whatever, Bool :$replace ) + our multi method grab ( $bag: Int $num = 1 ) + our multi method grab ( $bag: Whatever ) + our multi method grabpairs ( $bag: Int $num = 1 ) + our multi method grabpairs ( $bag: Whatever ) Like C, a C returns a random selection of elements, weighted by the values corresponding to each key. @@ -1045,7 +1045,7 @@ works directly on the C, modifying it in place. (You may use C<.pick> to treat the C as immutable; this will copy it and grab only from the temporary copy.) -Swiping without replacement (the default) decrements the grabbed +Grabbing decrements the grabbed key's replication value by one (deleting the key when it goes to 0). By definition, C<.elems> of the bag also decreases by one, so the probabilities stay consistent through subsequent grab operations.