变量

简介

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

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

Below is a list of all blocks:

Numeric Variables — Store and modify numbers.

• numeric variable — Returns the value of a numeric variable.

• set numeric variable — Assigns a value to a numeric variable.

• change numeric variable — Increases or decreases a numeric variable by a set amount.

Boolean Variables — Store True or False values.

• Boolean variable — Returns the value of a Boolean variable.

• set Boolean variable — Assigns a True or False value to a Boolean variable.

Lists — Store and manage collections of values.

• list item — Returns a value from a list based on its position.

• replace list item — Updates a specific item in a list.

• set list items — Assigns values to a list.

• length of list — Returns the number of items in a list.

2D Lists — Store and manage collection of values in a grid.

• 2D list item — Returns a value from a specific row and column in a 2D list.

• replace 2D list item — Updates a specific item in a 2D list.

• set 2D list items — Assigns values to a 2D list.

• length of 2D list — Returns the number of rows or columns in a 2D list.

Numeric Variables

数字变量

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

数字变量报告指令块。

(my_variable)

参数	描述
	该指令块没有参数。

示例

当开始
[Display the value of the variable plus two.]
设定 [my_variable v] 为 [2]
在屏幕上打印 ((my_variable) [math_plus v] [2])▶

设置数字变量

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

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

示例

当开始
[Set a variable to 10 and display it.]
设定 [my_variable v] 为 [10]
在屏幕上打印 (my_variable)▶

改变数值变量

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

改变数值变量指令段。

将 [my_variable v] 改变 (1)

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

示例

当开始
[Increase the variable by 5 and display it.]
设定 [my_variable v] 为 [10]
将 [my_variable v] 改变 [5]
在屏幕上打印 (my_variable)▶

Boolean Variables

布尔变量

布尔变量指令块用于返回真或假值。

布尔变量报告块。

<my_boolean>

参数	描述
	该指令块没有参数。

示例

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

设置布尔变量

设置布尔变量指令块为布尔变量分配真或假值。

设置布尔变量指令段。

设定 [my_boolean v] 为 <true v>

参数	描述
变量	要赋值的布尔变量。用户可以选择现有变量、重命名或删除它。
值	布尔值（真或假）。

示例

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

Lists

列表项

列表项指令块用于返回列表中某项的值。

列表项报告指令块。

([my_list v] 元素 (1))

参数	描述
索引	列表中项目的位置（从 1 开始）。
变量	要返回项目的列表变量。用户可以选择现有列表、重命名或删除它。

示例

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

替换列表项

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

替换列表项指令段。

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

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

示例

当开始
[Replace the first item in a list with "Sports Ball".]
设定 [my_list v] 为 [Robot] [Orange Barrel] [Blue Barrel]
将 [my_list v] 元素 (1) 置换为 (1)
在屏幕上打印 ([my_list v] 元素 (1))▶

设置列表项

设置列表项指令块可将列表中所有元素设置为输入的值。

设置列表项指令段。

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

参数	描述
变量	需要赋值的列表变量。用户可选择现有列表、重命名或删除它。
值	需要存储到列表中的值，需以独立项的形式逐个输入。

示例

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

列表长度

列表长度指令块返回列表中元素的数量。

列表长度报告指令块。

([my_list v] 长度 :: list)

参数	描述
变量	要获取长度的列表变量。用户可选择现有列表、重命名或删除它。

示例

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

2D Lists

二维列表项

2D 列表项 指令块用于返回二维列表中指定位置元素的值。

2D 列表项报告指令块。

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

参数	描述
行	元素所在的行（从 1 开始计数）。
列	元素所在的列（从 1 开始计数）。
变量	需要从中获取元素的二维列表变量。用户可选择现有二维列表、重命名或删除它。

示例

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

替换二维列表项

替换二维列表项指令块用于更新二维列表中的特定元素。

替换二维列表项指令段。

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

参数	描述
行	元素所在的行索引（从 1 开始计数）。
列	元素所在的列索引（从 1 开始计数）。
变量	包含待修改元素的二维列表变量。用户可通过下拉菜单选择现有二维列表、重命名或删除它。
值	赋给指定二维列表项的新值。

示例

当开始
[Replace a value in a 2D list and print the updated item.]
设定 [my_2d_list v] 为 ([1][Orange Barrel]) ([3][Blue Barrel])
将 [Sports Ball] 元素 [2][2] 置换为 [my_2d_list v]
在屏幕上打印 ([my_2d_list v] 元素 (2)(2))▶

设置二维列表项

设置二维列表项指令块可将二维列表中所有元素设置为输入的值。

替换二维列表项指令段。

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

参数	描述
变量	需要赋值的二维列表变量。用户可选择现有二维列表、重命名或删除它。
值	需要存储到二维列表中的值，需逐行输入。

示例

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

二维列表的长度

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][Orange Barrel]) ([3][Blue Barrel])
在屏幕上打印 ([my_2d_list v] 的 [rows v] 数)▶