控制

介绍

控件包括用于计时、程序流程、条件逻辑和项目终止的方法。这些控件允许您暂停执行、创建循环、定义逻辑路径以及结束程序。以下是可用控件的列表，包括方法和核心 Python 关键字：

• wait — Pauses execution for a given number of milliseconds or seconds.

• for — Repeats code for each item in a sequence.

• if — Executes code if a condition is true.

• if/else — Runs different code depending on a condition.

• if/elif/else — Checks multiple conditions in order.

• while — Repeats code while a condition is true.

• break — Exits a loop immediately.

• stop_program — Ends the running program.

• pass — Placeholder used when no action is needed.

等待

wait pauses for a specific amount of time before moving to the next method.

Usage:
wait(time, units)

参数	描述
time	等待的时间量，以正整数表示。
units	MSEC (default) SECONDS

# Turn right for one second, then stop
drivetrain.turn(RIGHT)
wait(1, SECONDS)
drivetrain.stop()

为了

for iterates over a sequence (such as a list, tuple, dictionary, set, or string) or any iterable object. It executes the block of code once for each item in the sequence.

使用量：

for value in expression_list:
    pass

参数	描述
value	存储迭代中的当前元素的临时变量。
expression_list	循环遍历的元素集合（例如，列表、字符串、范围）。

# Move in a square path
for index in range(4):
    drivetrain.drive_for(FORWARD, 100, MM)
    drivetrain.turn_for(RIGHT, 90)

# Print each item in the list
colors = ["Red", "Green", "Blue"]

for color in colors:
    brain.screen.print(color)
    brain.screen.next_row()

如果

if executes the indented block of code if the condition evaluates as True.

用法：

if condition:
    pass

参数	描述
condition	An expression or variable that is evaluated when the statement runs. If it evaluates as True, the code inside the if block executes; if it evaluates as False, the block is skipped.

# Turn right when a button is pressed
while True:
    if brain.buttonCheck.pressing():
        drivetrain.turn_for(RIGHT, 90)
    wait(0.1, SECONDS)

如果/否则

if and else determine which indented block of code runs based on whether the condition evaluates as True or False.

用法：

if condition:
    pass
else:
    pass

参数	描述
condition	An expression or variable that is evaluated when the statement runs. If it evaluates as True, the code inside the if block executes; if it evaluates as False, the code inside the else block executes instead.

# Turn right when a button is pressed, and remain still
# when the button is not pressed
while True:
    if brain.buttonCheck.pressing():
        drivetrain.turn(RIGHT)
    else:
        drivetrain.stop()
    wait(0.1, SECONDS)

如果/否则

The if/elif/else structure selects which indented block of code runs based on conditions:

• if runs its block if the condition evaluates as True.

• elif checks additional conditions only if all previous conditions evaluated as False. Multiple elif statements can be used.

• else runs its block only if none of the previous conditions evaluated as True.

用法：

if condition:
    pass
elif condition:
    pass
else:
    pass

参数	描述
condition	An expression or variable that is evaluated when the statement runs. The first condition that evaluates as True determines which block executes; if none are True, the else block runs.

# Turn depending on what button is pressed
while True:
    if brain.buttonRight.pressing():
        drivetrain.turn(RIGHT)
    elif brain.buttonLeft.pressing():
        drivetrain.turn(LEFT)
    else:
        drivetrain.stop()
    wait(0.1, SECONDS)

尽管

while repeatedly runs methods as long as the condition is True. It can also be used like a “Wait until” by adding not to the condition, as shown in the example below.

用法：

while condition:
    pass

参数	描述
condition	An expression or variable that is evaluated before each iteration. If it evaluates as True, the loop continues; if it evaluates as False, the loop stops.

# Keep the screen green while the robot is moving
drivetrain.drive_for(FORWARD, 200, MM, wait=False)
while drivetrain.is_moving():
    brain.screen.clear_screen(Color.GREEN)
    wait(50, MSEC)

brain.screen.clear_screen(Color.BLACK)

while True:
    # Move in a square path forever
    drivetrain.drive_for(FORWARD, 150, MM)
    drivetrain.turn_for(RIGHT, 90)

# Wait until a button is pressed to stop driving
drivetrain.drive(FORWARD)
while not brain.buttonCheck.pressing():
    wait(50, MSEC)
drivetrain.stop()

休息

break exits a loop immediately.

# Stop turning after a button is pressed
while True:
    drivetrain.turn(RIGHT)
    if brain.buttonCheck.pressing():
        break
drivetrain.stop()
brain.play_sound(SoundType.POWER_DOWN)

停止程序

program_stop ends a running project.

Usage:
brain.program_stop()

参数	描述
	该方法没有参数。

# Stop the project after a button is pressed
while True:
    drivetrain.turn(RIGHT)
    if brain.buttonCheck.pressing():
        brain.program_stop()
    brain.play_sound(SoundType.POWER_DOWN)

经过

pass is a placeholder for future code and can be used to avoid errors in empty loops, conditionals, and functions.

if condition:
    pass

def function():
    pass