Merge pull request #867 from pietroalbini/loop_break_value

Add an example about returning values with break

examples/flow_control/loop/return/input.md

@@ -0,0 +1,6 @@
+One of the uses of a `loop` is to retry an operation until it succeded. If the
+operation returns a value though, you might need to pass it to the rest of the
+code: put it after the `break`, and it will be returned by the `loop`
+expression.
+
+{return.play}

examples/flow_control/loop/return/return.rs

@@ -0,0 +1,13 @@
+fn main() {
+    let mut counter = 0;
+
+    let result = loop {
+        counter += 1;
+
+        if counter == 10 {
+            break counter * 2;
+        }
+    };
+
+    assert_eq!(result, 20);
+}

examples/structure.json

@@ -37,7 +37,8 @@
     { "id": "flow_control", "title": "Flow Control", "children": [
         { "id": "if_else", "title": "if/else", "children": null },
         { "id": "loop", "title": "loop", "children": [
-            { "id": "nested", "title": "Nesting and labels", "children": null }
+            { "id": "nested", "title": "Nesting and labels", "children": null },
+            { "id": "return", "title": "Returning from loops", "children": null }
         ] },
         { "id": "while", "title": "while", "children": null },
         { "id": "for", "title": "for and range", "children": null },