變數

介紹

VEXcode AIR 中的變數模組可讓您儲存專案稍後可以使用的資訊。變數就像一個帶有標籤的容器，用於保存值，例如數字、布林值或項目清單。

當你想讓專案在運行過程中記住某些資訊時，就可以使用變數。例如，變數可以記錄無人機的移動次數、計數到的物體數量，或是否達到了某個目標。

當項目中的信息可能會發生變化時，變數就非常有用。與其在多個重複編寫相同的數字或答案，不如將其儲存在變數中，並在專案運行時進行更新。這樣一來，專案的修改、檢查和理解就變得更加容易。

在 VEXcode AIR 中，變數模組可以儲存不同類型的信息，包括數字、布林值（例如真或假）、列表和二維列表。當專案需要進行計數、做出決策、追蹤進度或組織資訊時，這些模組非常有用。

以下是可用區塊的清單：

數字變數 - 儲存和修改數字。

• 數字變數 — 報告數字變數的值。

• 設定數字變數－為數字變數指派一個值。

• 更改數字變數 — 將數字變數增加或減少一定量。

布林變數－儲存 真 或 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] [mm v] ▶
移動 [前方 v] (fly_distance) [mm v] ▶
等待 (1) 秒
移動 [backward v] (fly_distance) [mm v] ▶
等待 (1) 秒
降落 ▶

設定數值變數

設定數值變數堆疊區塊為數值變數賦值。

範圍	描述
多變的	要賦值的數字變數。使用者可以選擇現有變數、重新命名或刪除它。
價值	分配給變數的數字（可以是整數、小數或數字塊）。

例子

當開始時
[Set a variable to fly forward and back the same distance.]
設定 [fly_distance v] 為 [90]
起飛至 [500] [mm v] ▶
移動 [前方 v] (fly_distance) [mm v] ▶
等待 (1) 秒
移動 [backward v] (fly_distance) [mm v] ▶
等待 (1) 秒
降落 ▶

更改數值變數

更改數值變數堆疊塊將變數的值增加或減少給定的量。

改變數值變數堆疊塊。

將 [my_variable v] 改變 (1)

範圍	描述
多變的	要修改的數字變數。使用者可以選擇現有變數、重新命名或刪除它。
價值	增加或減少變數的量。

例子

當開始時
[Fly forward for 50, 150, and 250mm.]
設定 [fly_distance v] 為 [50]
起飛至 [500] [mm v] ▶
重複 (3) 次
移動 [前方 v] (fly_distance) [mm 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>

範圍	描述
多變的	要賦值的布林變數。使用者可以選擇現有變數、重新命名或刪除它。
價值	布林值（真或假）。

例子

當開始時
[Repeat until 3 deliveries are made.]
起飛至 [500] [mm v] ▶
設定 [finished v] 為 <false v>
設定 [deliveries v] 為 [0]
重複直到 <finished>
移動 [前方 v] (100) [mm v] ▶
將 [deliveries v] 改變 [1]

如果 <(deliveries) [math_equal v] [3]> 則
設定 [finished v] 為 <true v>
結束
結束
降落 ▶

清單

清單項

列表項報告區塊用於報告清單中某項的值。列表是一種變量，可以儲存多個相同類型的變數。

列表項報告器區塊。

([my_list v] 的第 (1) 項)

範圍	描述
指數	清單中項目的位置（從 1 開始）。
多變的	用於報告項目的列表變數。使用者可以選擇現有清單、重新命名或刪除它。

例子

當開始時
[Display the delivery locations.]
起飛至 [500] [mm v] ▶
將 [delivery_spots v] 設定為 [Red House] [Green House] [Blue House]
移動 [前方 v] (100) [mm v] ▶
在螢幕上列印 ([delivery_spots v] 的第 (1) 項) ▶
移動 [前方 v] (100) [mm v] ▶
在螢幕上列印 ([delivery_spots v] 的第 (2) 項) ▶
移動 [前方 v] (100) [mm v] ▶
在螢幕上列印 ([delivery_spots v] 的第 (3) 項) ▶
降落 ▶

替換列表項

替換清單項目堆疊區塊用於更新清單中的特定項目。

替換列表項堆疊塊。

將 [my_list v] 第 (1) 項替換為 (1)

範圍	描述
多變的	包含要修改的項目的列表變數。使用者可以選擇現有清單、重新命名或刪除它。
指數	清單中項目的位置（從 1 開始）。
價值	指派給指定清單項目的新值。

例子

當開始時
[Replace the first item in a list with "AprilTag".]
將 [my_list v] 設定為 [Drone] [Controller] [Headset]
將 [my_list v] 第 (1) 項替換為 [AprilTag]
在螢幕上列印 ([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) ▶

二維列表

二維列表項

二維清單項目報告區塊用於報告二維清單中某項的值。二維列表是儲存多個list變數的變數。

2D 列表項目報告器區塊。

([my_2d_list v] 的第 (1)(1) 項)

範圍	描述
排	項目的行（從 1 開始）。
柱子	項目的列（從 1 開始）。
多變的	用於報告項目的二維列表變數。使用者可以選擇現有的二維列表，對其進行重新命名或刪除。

例子

當開始時
[Display an item from a 2D list.]
將 [my_2d_list v] 設定為 ([1] [Drone]) ([4] [Propeller])
在螢幕上列印 ([my_2d_list v] 的第 (2)(2) 項) ▶

替換二維列表項

取代二維列表項目堆疊區塊用於更新二維列表中的特定項目。

取代 2D 列表項目堆疊塊。

將 [my_2d_list v] 第 (1)(1) 項替換為 (1)

範圍	描述
排	項目的行索引（從 1 開始）。
柱子	項目的列索引（從 1 開始）。
多變的	包含要修改的項目的二維列表變數。使用者可以從下拉式選單中選擇現有的二維清單、重新命名或刪除它。
價值	指派給指定二維列表項的新值。

例子

當開始時
[Replace a value in a 2D list and print the updated item.]
將 [my_2d_list v] 設定為 ([1] [Drone]) ([4] [Propeller])
將 [my_2d_list v] 第 [2][2] 項替換為 [Headset]
在螢幕上列印 ([my_2d_list v] 的第 (2)(2) 項) ▶

設定二維列表項

設定 2D 清單項目 堆疊區塊將 2D 清單中的每個項目設定為輸入的值。

取代 2D 列表項目堆疊塊。

將 [my_2d_list v] 設定為 ([0] [0]) ([0] [0])

範圍	描述
多變的	正在賦值的二維列表變數。使用者可以選擇現有的二維列表，重新命名或刪除它。
價值觀	逐行輸入要儲存在二維清單中的值。

例子

當開始時
[Display an item from a 2D list.]
將 [my_2d_list v] 設定為 ([1] [Drone]) ([4] [Propeller])
在螢幕上列印 ([my_2d_list v] 的第 (1)(2) 項) ▶

二維列表的長度

二維列表長度報告區塊報告二維列表中的行數或列數。

2D 清單報告區塊的長度。

([my_2d_list v] 的 [列 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] 的 [列 v] 長度) ▶