doc sub take-rw

Author: gfldex

doc/Type/Mu.pod6

@@ -337,6 +337,18 @@ Takes the given item and passes it to the enclosing C<gather> block.
         take (1 .. $max-lotto-numbers).pick(1);
     }.say;    #-> 32 22 1 17 32 9  (for example)
 
+=head2 routine take-rw
+
+    sub take-rw(\item)
+
+Returns the given item to the enclosing C<gather> block, without introducing a new container.
+
+    my @a = 1...3;
+    sub f(@list){ gather for @list { take-rw $_ } };
+    for f(@a) { $_++ };
+    say @a;
+    # OUTPUT«[2 3 4]␤»
+
 =head2 method so
 
     method so()