Document class Label

Author: moritz

lib/Type/Label.pod

@@ -0,0 +1,38 @@
+=begin pod
+
+=TITLE class Label
+
+=SUBTITLE Labels for control operations such as C<next> and C<last>
+
+    class Label { ... }
+
+In Perl 6, you can give for example loops a label, and use it to control that
+loop (instead of the inner-most loop).
+
+    USERS:          # the label
+    for @users -> $u {
+        for $u.pets -> $pet {
+            # usage of a label
+            next USERS if $pet.barks;
+        }
+        say "None of {$u}'s pets barks";
+    }
+    say USERS.^name;        # Label
+
+Those label are objects of type C<Label>.
+
+=head1 Methods
+
+=head2 method next
+
+    method next(Label:)
+
+Begin the next iteration of the loop assoicated with the label.
+
+=head2 method last
+
+    method last(Label:)
+
+Terminate the execution of the loop assoicated with the label.
+
+=end pod