aboutsummaryrefslogtreecommitdiff
path: root/doc/language/cpsc-keyword-for.7.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/language/cpsc-keyword-for.7.md')
-rw-r--r--doc/language/cpsc-keyword-for.7.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/doc/language/cpsc-keyword-for.7.md b/doc/language/cpsc-keyword-for.7.md
new file mode 100644
index 0000000..201a492
--- /dev/null
+++ b/doc/language/cpsc-keyword-for.7.md
@@ -0,0 +1,35 @@
+% CPSC-KEYWORD-FOR(7)
+
+# NAME
+
+cpsc-keyword-for - iterate over an integer range
+
+# SYNOPSIS
+
+```text
+FOR variable <- start TO finish [STEP increment]
+ statements
+NEXT variable
+```
+
+# DESCRIPTION
+
+The loop variable must already be declared INTEGER. Both endpoints are
+inclusive. STEP defaults to 1; use a negative value to count down.
+STEP is evaluated once, while the finish expression is evaluated each
+iteration. NEXT must name the same variable. Use a nonzero STEP.
+TO, STEP, and NEXT belong to this syntax.
+
+# EXAMPLE
+
+```text
+DECLARE Index : INTEGER
+FOR Index <- 3 TO 1 STEP -1
+ OUTPUT Index
+NEXT Index
+```
+
+# SEE ALSO
+
+[cpsc-language-overview(7)](cpsc-language-overview.7.md), [cpsc-keyword-declare(7)](cpsc-keyword-declare.7.md), [cpsc-keyword-while(7)](cpsc-keyword-while.7.md).
+