变量

介绍

VEXcode 123 中的变量模块允许您存储项目稍后可以使用的信息。变量就像一个带标签的容器，用于保存值，例如数字、布尔值或项目列表。

当你想让项目在运行过程中记住某些信息时，就可以使用变量。例如，变量可以记录机器人移动的次数、计数的物体数量，或者是否达到了目标。

当项目中的信息可能会发生变化时，变量就非常有用。与其在多处重复写入相同的数字或答案，不如将其存储在变量中，并在项目运行时进行更新。这样一来，项目的修改、检查和理解就变得更加容易。

在 VEXcode 123 中，变量模块可以存储不同类型的信息，包括数字、布尔值（例如真或假）、列表和二维列表。当项目需要进行计数、做出决策、跟踪进度或组织信息时，这些模块非常有用。

以下是可用模块列表：

数值变量——存储和修改数字。

• 数值变量 – 报告数值变量的值。

• 设置数值变量 – 为数值变量赋值。

• 更改数值变量 – 将数值变量增加或减少一个设定的值。

布尔变量——存储真或假值。

• 布尔变量 – 报告布尔变量的值。

• 设置布尔变量 – 将 True 或 False 值赋给布尔变量。

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

• 列表项 – 根据列表中的位置报告该值。

• 替换列表项 – 更新列表中的特定项。

• 设置列表项 – 为列表赋值。

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

二维列表——以网格形式存储和管理值集合。

• 2D 列表项 – 报告 2D 列表中特定行和列的值。

• 替换二维列表项 – 更新二维列表中的特定项。

• 设置二维列表项 – 为二维列表赋值。

• 二维列表长度 – 报告二维列表中的行数或列数。

数值变量

数值变量

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

数值变量报告模块。

(myVariable)

范围	描述
	此代码块没有参数。

例子

当开始
[Display the value of the variable.]
设定 [deliveries v] 为 [2]
打印 (deliveries) ▶

设置数值变量

设置数值变量堆栈块为数值变量赋值。

设置数值变量报告器模块。

设定 [myVariable v] 为 [1]

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

例子

当开始
[Display the value of the variable.]
设定 [deliveries v] 为 [2]
打印 (deliveries) ▶

更改数值变量

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

更改数值变量堆栈块。

将 [myVariable v] 改变 (1)

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

例子

当开始
[Deliver a package twice.]
设定 [deliveries v] 为 [0]
驱动 [向前 v] (1) [步数 v]
将 [deliveries v] 改变 [1]
驱动 [向前 v] (1) [步数 v]
将 [deliveries v] 改变 [1]
打印 (deliveries) ▶

布尔变量

布尔变量

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

布尔变量报告器模块。

<myBoolean>

范围	描述
	此代码块没有参数。

例子

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

设置布尔变量

设置布尔变量堆栈块将True或False值赋给布尔变量。

设置布尔变量栈块。

设定 [myBoolean v] 为 <true v>

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

例子

当开始
[Repeat until 3 deliveries are made.]
设定 [finished v] 为 <false v>
设定 [deliveries v] 为 [0]
重复直到 <finished>
驱动 [向前 v] (1) [步数 v]
将 [deliveries v] 改变 [1]

如果 <(deliveries) [math_equal v] [3]> 那么
设定 [finished v] 为 <true v>

列表

列表项

列表项报告块用于报告列表中某个项的值。列表是一种变量，可以存储多个相同类型的变量。

列表项报告器模块。

([myList v] 元素 (1))

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

例子

当开始
[Display the delivery locations.]
设定 [delivery_spots v] 为 [Red House] [Green House] [Blue House]
驱动 [向前 v] (1) [步数 v]
打印 ([delivery_spots v] 元素 (1)) ▶
驱动 [向前 v] (1) [步数 v]
打印 ([delivery_spots v] 元素 (2)) ▶
驱动 [向前 v] (1) [步数 v]
打印 ([delivery_spots v] 元素 (3)) ▶

替换列表项

替换列表项堆栈块用于更新列表中的特定项。

替换列表项堆栈块。

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

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

例子

当开始
[Replace the first item in a list with "Robot".]
设定 [my_list v] 为 [Red] [Green] [Blue]
将 [my_list v] 元素 (1) 置换为 (1)
打印 ([my_list v] 元素 (1)) ▶

歌单项目

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

设置列表项堆叠块。

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

范围	描述
多变的	列表变量正在被赋值。用户可以选择现有列表、重命名列表或删除列表。
值	要存储在列表中的值，以单个项目的形式输入。

例子

当开始
[Display a delivery locations.]
设定 [delivery_spots v] 为 [Red House] [Green House] [Blue House]
驱动 [向前 v] (1) [步数 v]
打印 ([delivery_spots v] 元素 (2)) ▶

列表长度

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

列表报告块的长度。

([myList v] 长度 :: list)

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

例子

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

二维列表

二维列表项

二维列表项报告块用于报告二维列表中某个项的值。二维列表是存储多个list变量的变量。

二维列表项报告模块。

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

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

例子

当开始
[Display an item from a 2D list.]
设定 [my_2d_list v] 为 ([1] [10]) ([2] [20])
打印 ([my_2d_list v] 元素 (2)(2)) ▶

替换二维列表项

替换二维列表项堆栈块用于更新二维列表中的特定项。

替换二维列表项堆栈块。

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

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

例子

当开始
[Replace a value in a 2D list and print the updated item.]
设定 [my_2d_list v] 为 ([1] [2]) ([3] [4])
将 [50] 元素 [2][2] 置换为 [my_2d_list v]
打印 ([my_2d_list v] 元素 (2)(2)) ▶

设置二维列表项

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

替换二维列表项堆栈块。

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

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

例子

当开始
[Display an item from a 2D list.]
设定 [my_2d_list v] 为 ([1] [10]) ([2] [20])
打印 ([my_2d_list v] 元素 (2)(2)) ▶

二维列表的长度

二维列表长度报告块报告二维列表中的行数或列数。

二维列表报告块的长度。

[my2DList v] 的 [rows v] 数

范围	描述
多变的	用于检查二维列表长度的变量。用户可以选择现有的二维列表，对其进行重命名或删除。
行/列	是报告行数还是列数。

例子

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