Control#
Introduction#
The Control blocks in VEXcode 123 manage the flow of a project by handling loops, conditions, delays, and stopping execution.
Below is a list of available blocks:
wait – Pauses execution for a specific duration.
wait until – Pauses execution until a specified condition is met.
repeat – Repeats enclosed blocks a specific number of times.
forever – Repeats enclosed blocks indefinitely.
repeat until – Repeats enclosed blocks until a condition is met.
while – Repeats enclosed blocks while a condition remains true.
if – Runs enclosed blocks if a condition is true.
if / else – Runs one set of blocks if a condition is true, otherwise runs another.
if / else if / else – Runs different sets of blocks depending on multiple conditions.
break – Exits a repeat, forever, repeat until, or while loop immediately.
stop project – Ends the execution of the project.
wait#
The wait block pauses for a specific amount of time before moving to the next block.
等待 (1) 秒
Parameters |
Description |
|---|---|
time |
The amount of time to wait, as a positive integer or decimal in seconds. |
Example
当开始 :: hat events
[Drive forward then stop.]
驱动 [向前 v]
等待 (2) 秒
驱动停止
wait until#
The wait until block pauses execution until a specified condition is met before proceeding to the next block.
等到 <>
Parameters |
Description |
|---|---|
condition |
The condition that must be met before moving on to the next block. |
Example
当开始 :: hat events
[Drive forward when the sound button is pressed.]
等到 <[soundIcon v] 按下了?>
驱动 [向前 v] [200] [毫米 v]
repeat#
The repeat block runs the blocks inside it a set number of times.
重复 [10]
结束
Parameters |
Description |
|---|---|
times |
A whole number that sets how many times the repeat block runs. |
Example
当开始 :: hat events
[Drive in a square pattern.]
重复 [4]
驱动 [向前 v] [200] [毫米 v]
[右 v] 转 [90] 度
forever#
The forever block keeps running the blocks inside it again and again without stopping.
永久循环
结束
Parameters |
Description |
|---|---|
This block has no parameters. |
Example
当开始 :: hat events
[Blink LED light in a pattern.]
永久循环
发光 [绿色 v]
等待 [0.5] 秒
发光 [灭 v]
等待 [0.5] 秒
repeat until#
The repeat until block executes the enclosed blocks repeatedly while the condition evaluates as False.
重复直到 <>
结束
Parameters |
Description |
|---|---|
condition |
An expression or variable that is evaluated before each iteration. If it evaluates as:
|
Example
当开始 :: hat events
[Blink LED light until the sound button is pressed.]
重复直到 <[soundIcon v] 按下了?>
发光 [绿色 v]
等待 [0.5] 秒
发光 [灭 v]
等待 [0.5] 秒
while#
The while block executes the enclosed blocks repeatedly while the condition evaluates as True.
当 <>
结束
Parameters |
Description |
|---|---|
condition |
An expression or variable that is evaluated before each iteration. If it evaluates as:
|
Example
当开始 :: hat events
[Turn the robot around.]
当 <(底盘归位角度值) [math_less_than v] [180]>
[右 v] 转
结束
驱动停止
if#
The if block executes the enclosed block of code if the condition evaluates as True.
如果 <> 那么
结束
Parameters |
Description |
|---|---|
condition |
An expression or variable that is evaluated when the statement runs. If it evaluates as:
|
Example
当开始 :: hat events
[Drive forward whenever the sound button is pressed.]
永久循环
如果 <[soundIcon v] 按下了?> 那么
驱动 [向前 v] [200] [毫米 v]
if / else#
The if / else block determines which enclosed block of code runs based on whether the condition evaluates as True or False.
如果 <> 那么
否则
结束
Parameters |
Description |
|---|---|
condition |
An expression or variable that is evaluated when the statement runs. If it evaluates as:
|
Example
当开始 :: hat events
[Drive forward until a crash.]
永久循环
如果 <检测到碰撞?> 那么
驱动停止
否则
驱动 [向前 v] [200] [毫米 v]
if / else if / else#
The if / else if / else block structure selects which enclosed block of code runs based on conditions:
if runs its block of code if the condition evaluates as True.
else if checks additional conditions only if all previous conditions evaluated as False. Multiple else if statements can be used.
else runs its block of code only if none of the previous conditions evaluated as True.
如果 <> 那么
否则如果 <> 那么
否则
结束
Parameters |
Description |
|---|---|
condition |
An expression or variable that is evaluated when the statement runs. The first condition that evaluates as:
|
Example
当开始 :: hat events
[Turn right for the right button, left for the left button.]
永久循环
如果 <[ifbuttonright v] 按下了?> 那么
[右 v] 转
否则如果 <[ifbuttonleft v] 按下了?> 那么
[左 v] 转
否则
驱动停止
break#
The break block exits a loop immediately.
退出循环
Parameters |
Description |
|---|---|
This block has no parameters. |
Example
当开始 :: hat events
[Flash the LED until the sound button is pressed.]
永久循环
发光 [绿色 v]
等待 [0.5] 秒
发光 [蓝色 v]
等待 [0.5] 秒
如果 <[soundIcon v] 按下了?> 那么
退出循环
stop project#
The stop project block ends a running project.
停止程序
Parameters |
Description |
|---|---|
This block has no parameters. |
Example
当开始 :: hat events
[Stop the project after a crash.]
永久循环
驱动 [向前 v]
如果 <检测到碰撞?> 那么
停止程序