Merge pull request #176 from Flipez/loop-return

Flipez · web-flow · commit 71bb1c47d9b8 · 2022-12-19T20:35:50.000+01:00
[foreach/while] Document return value
diff --git a/docs/docs/control_expressions/foreach.md b/docs/docs/control_expressions/foreach.md
@@ -24,6 +24,23 @@ end
 input = a
 ```
 
+## Return Value
+Loops do return the variable they are iterating after the last loop.
+
+```js
+def iterate(items)
+  foreach item in items
+    puts(item)
+  end
+end
+
+a = [1,2,3,4,5]
+
+b = iterate(a)
+
+// b is now [1,2,3,4,5]
+```
+
 ## Using an integer
 Count form zero to a given number (excluding):
 
diff --git a/docs/docs/control_expressions/while.md b/docs/docs/control_expressions/while.md
@@ -45,4 +45,21 @@ end
 4
 5
 6
+```
+
+## Return Value
+Loops do return the variable they are iterating after the last loop.
+
+```js
+def iterate(items)
+  foreach item in items
+    puts(item)
+  end
+end
+
+a = [1,2,3,4,5]
+
+b = iterate(a)
+
+// b is now [1,2,3,4,5]
 ```

Original file line number	Diff line number	Diff line change
`@@ -45,4 +45,21 @@ end`
`45`	`45`	`4`
`46`	`46`	`5`
`47`	`47`	`6`
	`48`	+```
	`49`	`+`
	`50`	`+## Return Value`
	`51`	`+Loops do return the variable they are iterating after the last loop.`
	`52`	`+`
	`53`	+```js
	`54`	`+def iterate(items)`
	`55`	`+ foreach item in items`
	`56`	`+ puts(item)`
	`57`	`+ end`
	`58`	`+end`
	`59`	`+`
	`60`	`+a = [1,2,3,4,5]`
	`61`	`+`
	`62`	`+b = iterate(a)`
	`63`	`+`
	`64`	`+// b is now [1,2,3,4,5]`
`48`	`65`	```