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.

wait stack block#
等待 (1) 秒

Parameters

Description

time

The amount of time to wait, as a positive integer or decimal in seconds.

Example

aria-description goes here#
当开始 :: 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.

wait until stack block#
等到 <>

Parameters

Description

condition

The condition that must be met before moving on to the next block.

Example

aria-description goes here#
当开始 :: 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.

repeat c block#
重复 [10]
结束

Parameters

Description

times

A whole number that sets how many times the repeat block runs.

Example

aria-description goes here#
当开始 :: 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.

forever c block#
永久循环
结束

Parameters

Description

This block has no parameters.

Example

aria-description goes here#
当开始 :: 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.

repeat until block#
重复直到 <>
结束

Parameters

Description

condition

An expression or variable that is evaluated before each iteration. If it evaluates as:

  • False - The loop continues
  • True - The loop stops

Example

aria-description goes here#
当开始 :: 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.

while c block#
当 <>
结束

Parameters

Description

condition

An expression or variable that is evaluated before each iteration. If it evaluates as:

  • True - The loop continues
  • False - The loop stops

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.

if block#
如果 <> 那么
结束

Parameters

Description

condition

An expression or variable that is evaluated when the statement runs. If it evaluates as:

  • True - The code inside the if block executes
  • False - The block is skipped

Example

aria-description goes here#
当开始 :: 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.

if then else block#
如果 <> 那么
否则
结束

Parameters

Description

condition

An expression or variable that is evaluated when the statement runs. If it evaluates as:

  • True - The code inside the if block executes
  • False - The code inside the else block executes instead

Example

aria-description goes here#
当开始 :: 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.

if else if else block#
如果 <> 那么
否则如果 <> 那么
否则
结束

Parameters

Description

condition

An expression or variable that is evaluated when the statement runs. The first condition that evaluates as:

  • True - Determines which block of code executes
  • False - If none are True, the else block of code runs

Example

aria-description goes here#
当开始 :: 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.

break stack block#
退出循环

Parameters

Description

This block has no parameters.

Example

aria-description goes here#
当开始 :: 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.

stop project block#
停止程序

Parameters

Description

This block has no parameters.

Example

aria-description goes here#
当开始 :: hat events
[Stop the project after a crash.]
永久循环
驱动 [向前 v]
如果 <检测到碰撞?> 那么
停止程序