变量#

介绍 #

VEXcode AIR 中的变量块允许存储和管理数据，包括数字、布尔值、列表和二维列表。

要显示变量块，您必须先创建一个变量。使用“变量”类别中的“创建”按钮可以创建变量。所有变量默认都是全局变量，这意味着它们可以在项目的任何位置使用。

以下是可用块的列表：

数字变量 - 存储和修改数字。

数字变量 — 报告数字变量的值。
设置数字变量——为数字变量分配一个值。
更改数字变量 — 将数字变量增加或减少一定量。

布尔变量——存储 True 或 False 值。

布尔变量 — 报告布尔变量的值。
设置布尔变量 — 为布尔变量分配 True 或 False 值。

列表——存储和管理值的集合。

列表项 — 根据列表的位置报告列表中的值。
替换列表项 — 更新列表中的特定项目。
设置列表项 — 为列表分配值。
列表长度 — 返回列表中的项目数。

2D 列表——存储和管理网格中的值集合。

2D 列表项 — 报告 2D 列表中特定行和列的值。
替换二维列表项 — 更新二维列表中的特定项目。
设置 2D 列表项 — 为 2D 列表分配值。
二维列表的长度 — 返回二维列表中的行数或列数。

数值变量 #

数字变量报告块用于报告分配给变量的数字值。

数值变量报告块。#

(my_variable)

范围	描述
	该块没有参数。

例子

当开始
[Use a variable to fly forward and back the same distance.]
设定 [fly_distance v] 为 [90]
起飞至 [500] [毫米 v] ▶
将 [向前 v] 移至 (fly_distance) [毫米 v] ▶
等待 (1) 秒
将 [backward v] 移至 (fly_distance) [毫米 v] ▶
等待 (1) 秒
土地 ▶

设置数值变量 #

设置数字变量块为数字变量分配一个值。

范围	描述
多变的	要赋值的数字变量。用户可以选择现有变量、重命名或删除它。
价值	分配给变量的数字（可以是整数、小数或数字块）。

例子

当开始
[Set a variable to fly forward and back the same distance.]
设定 [fly_distance v] 为 [90]
起飞至 [500] [毫米 v] ▶
将 [向前 v] 移至 (fly_distance) [毫米 v] ▶
等待 (1) 秒
将 [backward v] 移至 (fly_distance) [毫米 v] ▶
等待 (1) 秒
土地 ▶

更改数值变量 #

改变数字变量块将变量的值增加或减少给定的量。

改变数值变量堆栈块。#

将 [my_variable v] 改变 (1)

范围	描述
多变的	要修改的数字变量。用户可以选择现有变量、重命名或删除它。
价值	增加或减少变量的量。

例子

当开始
[Fly forward for 50, 150, and 250mm.]
设定 [fly_distance v] 为 [50]
起飞至 [500] [毫米 v] ▶
重复 (3)
将 [向前 v] 移至 (fly_distance) [毫米 v] ▶
等待 (1) 秒
将 [fly_distance v] 改变 (100)
结束
土地 ▶

布尔变量 #

布尔变量块用于报告 True 或 False 值。

布尔变量报告块。#

<my_boolean>

范围	描述
	该块没有参数。

例子

当开始
[Display a message if the variable is set to True.]
设定 [my_boolean v] 为 <true v>
如果 <my_boolean> 那么
在屏幕上打印 [Boolean is True!]▶
结束

设置布尔变量 #

设置布尔变量块为布尔变量分配 True 或 False 值。

设置布尔变量堆栈块。#

设定 [my_boolean v] 为 <true v>

范围	描述
多变的	要赋值的布尔变量。用户可以选择现有变量、重命名或删除它。
价值	布尔值（True 或 False）。

例子

当开始
[Display different messages based on the Boolean value.]
设定 [my_boolean v] 为 <true v>
如果 <my_boolean> 那么
在屏幕上打印 [It's true!]▶
否则
在屏幕上打印 [That's false...]▶
结束

列表项 #

列表项块用于报告列表中某个项目的值。

列表项报告器块。#

((1) 元素 [my_list v])

范围	描述
指数	列表中项目的位置（从 1 开始）。
多变的	用于报告项目的列表变量。用户可以选择现有列表、重命名或删除它。

例子

当开始
[Display the second item from a list.]
设定 [my_list v] 为 [Drone] [Controller] [Headset]
在屏幕上打印 ((2) 元素 [my_list v])▶

替换列表项 #

替换列表项块更新列表中的特定项目。

替换列表项堆栈块。#

将 (1) 元素 [my_list v] 置换为 (1)

范围	描述
多变的	包含要修改的项目的列表变量。用户可以选择现有列表、重命名或删除它。
指数	列表中项目的位置（从 1 开始）。
价值	分配给指定列表项的新值。

例子

当开始
[Replace the first item in a list with "AprilTag".]
设定 [my_list v] 为 [Drone] [Controller] [Headset]
将 (1) 元素 [my_list v] 置换为 [AprilTag]
在屏幕上打印 ((1) 元素 [my_list v])▶

设置列表项 #

设置列表项块将列表中的每个项目设置为输入的值。

设置列表项堆栈块。#

设定 [my_list v] 为 [0] [0] [0]

范围	描述
多变的	正在分配值的列表变量。用户可以选择现有列表、重命名或删除它。
价值观	要存储在列表中的值，作为单独的项目输入。

例子

当开始
[Display the last item in a list.]
设定 [my_list v] 为 [Red] [Green] [Blue]
在屏幕上打印 ((3) 元素 [my_list v])▶

列表长度 #

列表长度块报告列表中的项目数。

列表长度报告块。#

([my_list v] 长度 :: list)

范围	描述
多变的	要报告长度的列表变量。用户可以选择现有列表、重命名或删除它。

例子

当开始
[Display how many items are in a list.]
设定 [my_list v] 为 [Red] [Green] [Blue]
在屏幕上打印 ([my_list v] 长度 :: list)▶

二维列表项 #

2D 列表项 块用于报告 2D 列表中某个项目的值。

2D 列表项报告器块。#

((1) 元素 (1)[my_2d_list v])

范围	描述
排	项目的行（从 1 开始）。
柱子	项目的列（从 1 开始）。
多变的	用于报告项目的二维列表变量。用户可以选择现有的二维列表，对其进行重命名或删除。

例子

当开始
[Display an item from a 2D list.]
设定 [my_2d_list v] 为 ([1][Drone]) ([4][Propeller])
在屏幕上打印 ((2) 元素 (2)[my_2d_list v])▶

替换二维列表项 #

替换二维列表项块更新二维列表中的特定项目。

替换 2D 列表项堆栈块。#

将 (1) 元素 (1)[my_2d_list v] 置换为 (1)

范围	描述
排	项目的行索引（从 1 开始）。
柱子	项目的列索引（从 1 开始）。
多变的	包含要修改的项目的二维列表变量。用户可以从下拉菜单中选择现有的二维列表、重命名或删除它。
价值	分配给指定二维列表项的新值。

例子

当开始
[Replace a value in a 2D list and print the updated item.]
设定 [my_2d_list v] 为 ([1][Drone]) ([4][Propeller])
将 [2] 元素 [2][my_2d_list v] 置换为 [Headset]
在屏幕上打印 ((2) 元素 (2)[my_2d_list v])▶

设置二维列表项 #

设置二维列表项块将二维列表中的每个项目设置为输入的值。

替换 2D 列表项堆栈块。#

设定 [my_2d_list v] 为 ([0][0]) ([0][0])

范围	描述
多变的	正在赋值的二维列表变量。用户可以选择现有的二维列表，重命名或删除它。
价值观	逐行输入要存储在二维列表中的值。

例子

当开始
[Display an item from a 2D list.]
设定 [my_2d_list v] 为 ([1][Drone]) ([4][Propeller])
在屏幕上打印 ((1) 元素 (2)[my_2d_list v])▶

二维列表的长度 #

2D 列表的长度块报告 2D 列表中的行数或列数。

2D 列表报告块的长度。#

([my_2d_list v] 的 [rows v] 数)

范围	描述
多变的	要检查长度的二维列表变量。用户可以选择一个现有的二维列表，重命名或删除它。
行/列	是否报告行或列的数量。

例子

当开始
[Set a 2D list and print the number of rows it has.]
设定 [my_2d_list v] 为 ([1][Drone]) ([4][Propeller])
在屏幕上打印 ([my_2d_list v] 的 [rows v] 数)▶