You are currently looking at the v6.0 - v8.2 docs (Reason v3.6 syntax edition). You can find the latest manual page here.
(These docs are equivalent to the old BuckleScript docs before the ReScript rebrand)
If-Else & Loops
ReScript supports if
, else
, ternary expression (a ? b : c
), for
and while
.
ReScript also supports our famous pattern matching, which will be covered in its own section
If-Else & Ternary
Unlike its JavaScript counterpart, ReScript's if
is an expression; they evaluate to their body's content:
let message = if (isMorning) {
"Good morning!"
} else {
"Hello!"
};
Note: an if-else
expression without the final else
branch implicitly gives ()
(aka the unit
type). So this:
if (showMenu) {
displayMenu();
};
is basically the same as:
if (showMenu) {
displayMenu();
} else {
();
};
Here's another way to look at it. This is clearly wrong:
RElet result = if (showMenu) {
1 + 2;
};
It'll give a type error, saying basically that the implicit else
branch has the type unit
while the if
branch has type int
. Intuitively, this makes sense: what would result
's value be, if showMenu
was false
?
We also have ternary sugar, but we encourage you to prefer if-else when possible.
let message = isMorning ? "Good morning!" : "Hello!"
if-else
and ternary are much less used in ReScript than in other languages; Pattern-matching kills a whole category of code that previously required conditionals.
For Loops
For loops iterate from a starting value up to (and including) the ending value.
for (i in startValueInclusive to endValueInclusive) {
Js.log(i);
};
// prints: 1 2 3, one per line
for (x in 1 to 3) {
Js.log(x);
};
You can make the for
loop count in the opposite direction by using downto
.
for (i in startValueInclusive downto endValueInclusive) {
Js.log(i);
};
// prints: 3 2 1, one per line
for (x in 3 downto 1) {
Js.log(x);
};
While Loops
While loops execute its body code block while its condition is true.
while (testCondition) {
// body here
};
Tips & Tricks
There's no loop-breaking break
keyword (nor early return
from functions, for that matter) in ReScript. However, we can break out of a while loop easily through using a mutable binding.
let break = ref(false);
while (!break.contents) {
if (Js.Math.random() > 0.3) {
break := true;
} else {
Js.log("Still running");
};
};